2fc3abef31
* build: implement matrix strategy for DIREGAPIC action
* build: add alpha compute files
* build: Include API channel in auto-generated PR
* build: fix matrix specification
* build: Have DIREGAPIC action use triggering ref or default branch
* build: remove the field ScratchDisks
The field was also removed purposefully in v1
* build: Add v1 proto for use as "previous proto" in conversion
* build: allow all matrix jobs to complete even if some fail
* build: fix location of fail-fast setting
The original reference I used had it in the wrong place.
Correct GitHub ref: https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast
* build: Disable PHP and C# builds for alpha
PHP just failed. Not clear what the issue is.
C# has some known failures. One of them may be the use of 3 repeated fields.
* build: Disable Ruby generation
This was causing some errors, too.
* build: fix version in Discovery file before further processing
* build: jq is supposedly pre-installed in GitHub actions
* feat: Move alpha to v1alpha in all paths
* build: We do need to install jq
* build: Try installing without sudo
sudo is not found!
* build: Fix regex
"version" is the last field, so it has no trailing comma
* build: Fix Go imports in BUILD
* build: prepare for processing beta: copy files from alpha
* build: update the beta file contents to refer to beta symbols
* build: configure action to run for beta as well.
* build: Have each channel use its own branch for the PR
* Update syntax for matrix.version in branch name
* add initial versions of alpha/beta discovery docs
* Revert "add initial versions of alpha/beta discovery docs"
This reverts commit
|
||
|---|---|---|
| .cloudbuild | ||
| .github | ||
| .kokoro | ||
| gapic/metadata | ||
| grafeas | ||
| .bazeliskrc | ||
| .bazelrc | ||
| .gitignore | ||
| api-index-v1.json | ||
| BUILD.bazel | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| Makefile | ||
| PACKAGES.md | ||
| README.md | ||
| repository_rules.bzl | ||
| SECURITY.md | ||
| WORKSPACE | ||
Google APIs
This repository contains the original interface definitions of public Google APIs that support both REST and gRPC protocols. Reading the original interface definitions can provide a better understanding of Google APIs and help you to utilize them more efficiently. You can also use these definitions with open source tools to generate client libraries, documentation, and other artifacts.
Building
Bazel
The recommended way to build the API client libraries is through Bazel >= 4.2.2.
First, install bazel.
To build all libraries:
bazel build //...
To test all libraries:
bazel test //...
To build one library in all languages:
bazel build //google/example/library/v1/...
To build the Java package for one library:
bazel build //google/example/library/v1:google-cloud-example-library-v1-java
Bazel packages exist in all the libraries for Java, Go, Python, Ruby, Node.js, PHP and C#.
Overview
Google APIs are typically deployed as API services that are hosted under different DNS names. One API service may implement multiple APIs and multiple versions of the same API.
Google APIs use Protocol Buffers version 3 (proto3) as their Interface Definition Language (IDL) to define the API interface and the structure of the payload messages. The same interface definition is used for both REST and RPC versions of the API, which can be accessed over different wire protocols.
There are several ways of accessing Google APIs:
-
JSON over HTTP: You can access all Google APIs directly using JSON over HTTP, using Google API client library or third-party API client libraries.
-
Protocol Buffers over gRPC: You can access Google APIs published in this repository through GRPC, which is a high-performance binary RPC protocol over HTTP/2. It offers many useful features, including request/response multiplex and full-duplex streaming.
-
Google Cloud Client Libraries: You can use these libraries to access Google Cloud APIs. They are based on gRPC for better performance and provide idiomatic client surface for better developer experience.
Discussions
This repo contains copies of Google API definitions and related files. For discussions or to raise issues about Google API client libraries, GRPC or Google Cloud Client Libraries please refer to the repos associated with each area.
Repository Structure
This repository uses a directory hierarchy that reflects the Google API product structure. In general, every API has its own root directory, and each major version of the API has its own subdirectory. The proto package names exactly match the directory: this makes it easy to locate the proto definitions and ensures that the generated client libraries have idiomatic namespaces in most programming languages. Alongside the API directories live the configuration files for the GAPIC toolkit.
NOTE: The major version of an API is used to indicate breaking change to the API.
Generate gRPC Source Code
To generate gRPC source code for Google APIs in this repository, you
first need to install both Protocol Buffers and gRPC on your local
machine, then you can run make LANGUAGE=xxx all to generate the
source code. You need to integrate the generated source code into
your application build system.
NOTE: The Makefile is only intended to generate source code for the entire repository. It is not for generating linkable client library for a specific API. Please see other repositories under https://github.com/googleapis for generating linkable client libraries.
Go gRPC Source Code
It is difficult to generate Go gRPC source code from this repository, since Go has different directory structure. Please use this repository instead.