@ondewo/csi-client-angular 2.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +191 -0
- package/README.md +27 -0
- package/api/google/api/annotations.pb.d.ts +1 -0
- package/api/google/api/http.pb.d.ts +275 -0
- package/api/google/rpc/status.pb.d.ts +82 -0
- package/api/google/type/latlng.pb.d.ts +76 -0
- package/api/ondewo/csi/conversation.pb.d.ts +1312 -0
- package/api/ondewo/csi/conversation.pbconf.d.ts +6 -0
- package/api/ondewo/csi/conversation.pbsc.d.ts +167 -0
- package/api/ondewo/nlu/agent.pb.d.ts +3536 -0
- package/api/ondewo/nlu/agent.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/agent.pbsc.d.ts +472 -0
- package/api/ondewo/nlu/aiservices.pb.d.ts +2472 -0
- package/api/ondewo/nlu/aiservices.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/aiservices.pbsc.d.ts +150 -0
- package/api/ondewo/nlu/common.pb.d.ts +75 -0
- package/api/ondewo/nlu/context.pb.d.ts +756 -0
- package/api/ondewo/nlu/context.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/context.pbsc.d.ts +119 -0
- package/api/ondewo/nlu/entity-type.pb.d.ts +2014 -0
- package/api/ondewo/nlu/entity-type.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/entity-type.pbsc.d.ts +216 -0
- package/api/ondewo/nlu/intent.pb.d.ts +6236 -0
- package/api/ondewo/nlu/intent.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/intent.pbsc.d.ts +456 -0
- package/api/ondewo/nlu/operation-metadata.pb.d.ts +166 -0
- package/api/ondewo/nlu/operations.pb.d.ts +578 -0
- package/api/ondewo/nlu/operations.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/operations.pbsc.d.ts +87 -0
- package/api/ondewo/nlu/project-role.pb.d.ts +576 -0
- package/api/ondewo/nlu/project-role.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/project-role.pbsc.d.ts +103 -0
- package/api/ondewo/nlu/project-statistics.pb.d.ts +295 -0
- package/api/ondewo/nlu/project-statistics.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/project-statistics.pbsc.d.ts +151 -0
- package/api/ondewo/nlu/server-statistics.pb.d.ts +71 -0
- package/api/ondewo/nlu/server-statistics.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/server-statistics.pbsc.d.ts +72 -0
- package/api/ondewo/nlu/session.pb.d.ts +2892 -0
- package/api/ondewo/nlu/session.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/session.pbsc.d.ts +247 -0
- package/api/ondewo/nlu/user.pb.d.ts +1577 -0
- package/api/ondewo/nlu/user.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/user.pbsc.d.ts +263 -0
- package/api/ondewo/nlu/utility.pb.d.ts +1814 -0
- package/api/ondewo/nlu/utility.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/utility.pbsc.d.ts +150 -0
- package/api/ondewo/nlu/webhook.pb.d.ts +401 -0
- package/api/ondewo/nlu/webhook.pbconf.d.ts +6 -0
- package/api/ondewo/nlu/webhook.pbsc.d.ts +70 -0
- package/api/ondewo/s2t/speech-to-text.pb.d.ts +3710 -0
- package/api/ondewo/s2t/speech-to-text.pbconf.d.ts +6 -0
- package/api/ondewo/s2t/speech-to-text.pbsc.d.ts +263 -0
- package/api/ondewo/t2s/text-to-speech.pb.d.ts +3302 -0
- package/api/ondewo/t2s/text-to-speech.pbconf.d.ts +11 -0
- package/api/ondewo/t2s/text-to-speech.pbsc.d.ts +296 -0
- package/esm2020/api/google/api/annotations.pb.mjs +2 -0
- package/esm2020/api/google/api/http.pb.mjs +524 -0
- package/esm2020/api/google/rpc/status.pb.mjs +138 -0
- package/esm2020/api/google/type/latlng.pb.mjs +119 -0
- package/esm2020/api/ondewo/csi/conversation.pb.mjs +2232 -0
- package/esm2020/api/ondewo/csi/conversation.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/csi/conversation.pbsc.mjs +315 -0
- package/esm2020/api/ondewo/nlu/agent.pb.mjs +6077 -0
- package/esm2020/api/ondewo/nlu/agent.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/agent.pbsc.mjs +886 -0
- package/esm2020/api/ondewo/nlu/aiservices.pb.mjs +4371 -0
- package/esm2020/api/ondewo/nlu/aiservices.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/aiservices.pbsc.mjs +284 -0
- package/esm2020/api/ondewo/nlu/common.pb.mjs +108 -0
- package/esm2020/api/ondewo/nlu/context.pb.mjs +1233 -0
- package/esm2020/api/ondewo/nlu/context.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/context.pbsc.mjs +225 -0
- package/esm2020/api/ondewo/nlu/entity-type.pb.mjs +3466 -0
- package/esm2020/api/ondewo/nlu/entity-type.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/entity-type.pbsc.mjs +406 -0
- package/esm2020/api/ondewo/nlu/intent.pb.mjs +10809 -0
- package/esm2020/api/ondewo/nlu/intent.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/intent.pbsc.mjs +856 -0
- package/esm2020/api/ondewo/nlu/operation-metadata.pb.mjs +382 -0
- package/esm2020/api/ondewo/nlu/operations.pb.mjs +1003 -0
- package/esm2020/api/ondewo/nlu/operations.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/operations.pbsc.mjs +165 -0
- package/esm2020/api/ondewo/nlu/project-role.pb.mjs +988 -0
- package/esm2020/api/ondewo/nlu/project-role.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/project-role.pbsc.mjs +195 -0
- package/esm2020/api/ondewo/nlu/project-statistics.pb.mjs +460 -0
- package/esm2020/api/ondewo/nlu/project-statistics.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/project-statistics.pbsc.mjs +285 -0
- package/esm2020/api/ondewo/nlu/server-statistics.pb.mjs +103 -0
- package/esm2020/api/ondewo/nlu/server-statistics.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/server-statistics.pbsc.mjs +136 -0
- package/esm2020/api/ondewo/nlu/session.pb.mjs +5351 -0
- package/esm2020/api/ondewo/nlu/session.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/session.pbsc.mjs +465 -0
- package/esm2020/api/ondewo/nlu/user.pb.mjs +2536 -0
- package/esm2020/api/ondewo/nlu/user.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/user.pbsc.mjs +495 -0
- package/esm2020/api/ondewo/nlu/utility.pb.mjs +3302 -0
- package/esm2020/api/ondewo/nlu/utility.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/utility.pbsc.mjs +284 -0
- package/esm2020/api/ondewo/nlu/webhook.pb.mjs +705 -0
- package/esm2020/api/ondewo/nlu/webhook.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/nlu/webhook.pbsc.mjs +134 -0
- package/esm2020/api/ondewo/s2t/speech-to-text.pb.mjs +6452 -0
- package/esm2020/api/ondewo/s2t/speech-to-text.pbconf.mjs +13 -0
- package/esm2020/api/ondewo/s2t/speech-to-text.pbsc.mjs +495 -0
- package/esm2020/api/ondewo/t2s/text-to-speech.pb.mjs +5779 -0
- package/esm2020/api/ondewo/t2s/text-to-speech.pbconf.mjs +18 -0
- package/esm2020/api/ondewo/t2s/text-to-speech.pbsc.mjs +555 -0
- package/esm2020/ondewo-csi-client-angular.mjs +5 -0
- package/esm2020/public-api.mjs +55 -0
- package/fesm2015/ondewo-csi-client-angular.mjs +62142 -0
- package/fesm2015/ondewo-csi-client-angular.mjs.map +1 -0
- package/fesm2020/ondewo-csi-client-angular.mjs +62135 -0
- package/fesm2020/ondewo-csi-client-angular.mjs.map +1 -0
- package/index.d.ts +5 -0
- package/ondewo-csi-api/README.md +91 -0
- package/ondewo-csi-api/google/ads/googleads/README.md +21 -0
- package/ondewo-csi-api/google/api/README.md +5 -0
- package/ondewo-csi-api/google/api/servicecontrol/README.md +126 -0
- package/ondewo-csi-api/google/api/servicemanagement/README.md +102 -0
- package/ondewo-csi-api/google/appengine/README.md +12 -0
- package/ondewo-csi-api/google/assistant/embedded/README.md +3 -0
- package/ondewo-csi-api/google/cloud/functions/README.md +2 -0
- package/ondewo-csi-api/google/cloud/language/README.md +0 -0
- package/ondewo-csi-api/google/cloud/runtimeconfig/README.md +39 -0
- package/ondewo-csi-api/google/cloud/speech/README.md +3 -0
- package/ondewo-csi-api/google/container/README.md +0 -0
- package/ondewo-csi-api/google/datastore/README.md +0 -0
- package/ondewo-csi-api/google/devtools/cloudbuild/README.md +1 -0
- package/ondewo-csi-api/google/devtools/clouderrorreporting/README.md +1 -0
- package/ondewo-csi-api/google/example/library/README.md +4 -0
- package/ondewo-csi-api/google/firestore/README.md +0 -0
- package/ondewo-csi-api/google/genomics/README.md +14 -0
- package/ondewo-csi-api/google/iam/README.md +14 -0
- package/ondewo-csi-api/google/logging/README.md +3 -0
- package/ondewo-csi-api/google/longrunning/README.md +5 -0
- package/ondewo-csi-api/google/privacy/dlp/README.md +7 -0
- package/ondewo-csi-api/google/pubsub/v1beta2/README.md +136 -0
- package/ondewo-csi-api/google/rpc/README.md +5 -0
- package/ondewo-csi-api/google/streetview/publish/README.md +1 -0
- package/ondewo-csi-api/google/type/README.md +16 -0
- package/ondewo-csi-api/googleapis/README.md +87 -0
- package/ondewo-csi-api/googleapis/google/ads/googleads/README.md +21 -0
- package/ondewo-csi-api/googleapis/google/api/README.md +5 -0
- package/ondewo-csi-api/googleapis/google/api/servicecontrol/README.md +126 -0
- package/ondewo-csi-api/googleapis/google/api/servicemanagement/README.md +102 -0
- package/ondewo-csi-api/googleapis/google/appengine/README.md +12 -0
- package/ondewo-csi-api/googleapis/google/assistant/embedded/README.md +3 -0
- package/ondewo-csi-api/googleapis/google/cloud/functions/README.md +2 -0
- package/ondewo-csi-api/googleapis/google/cloud/language/README.md +0 -0
- package/ondewo-csi-api/googleapis/google/cloud/runtimeconfig/README.md +39 -0
- package/ondewo-csi-api/googleapis/google/cloud/speech/README.md +3 -0
- package/ondewo-csi-api/googleapis/google/container/README.md +0 -0
- package/ondewo-csi-api/googleapis/google/datastore/README.md +0 -0
- package/ondewo-csi-api/googleapis/google/devtools/cloudbuild/README.md +1 -0
- package/ondewo-csi-api/googleapis/google/devtools/clouderrorreporting/README.md +1 -0
- package/ondewo-csi-api/googleapis/google/example/library/README.md +4 -0
- package/ondewo-csi-api/googleapis/google/firestore/README.md +0 -0
- package/ondewo-csi-api/googleapis/google/genomics/README.md +14 -0
- package/ondewo-csi-api/googleapis/google/iam/README.md +14 -0
- package/ondewo-csi-api/googleapis/google/logging/README.md +3 -0
- package/ondewo-csi-api/googleapis/google/longrunning/README.md +5 -0
- package/ondewo-csi-api/googleapis/google/privacy/dlp/README.md +7 -0
- package/ondewo-csi-api/googleapis/google/pubsub/v1beta2/README.md +136 -0
- package/ondewo-csi-api/googleapis/google/rpc/README.md +5 -0
- package/ondewo-csi-api/googleapis/google/streetview/publish/README.md +1 -0
- package/ondewo-csi-api/googleapis/google/type/README.md +16 -0
- package/ondewo-csi-api/ondewo-nlu-api/README.md +117 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/README.md +87 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/ads/googleads/README.md +21 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/api/README.md +5 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/api/servicecontrol/README.md +126 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/api/servicemanagement/README.md +102 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/appengine/README.md +12 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/assistant/embedded/README.md +3 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/cloud/functions/README.md +2 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/cloud/language/README.md +0 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/cloud/runtimeconfig/README.md +39 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/cloud/speech/README.md +3 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/container/README.md +0 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/datastore/README.md +0 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/devtools/cloudbuild/README.md +1 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/devtools/clouderrorreporting/README.md +1 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/example/library/README.md +4 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/firestore/README.md +0 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/genomics/README.md +14 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/iam/README.md +14 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/logging/README.md +3 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/longrunning/README.md +5 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/privacy/dlp/README.md +7 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/pubsub/v1beta2/README.md +136 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/rpc/README.md +5 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/streetview/publish/README.md +1 -0
- package/ondewo-csi-api/ondewo-nlu-api/googleapis/google/type/README.md +16 -0
- package/ondewo-csi-api/ondewo-s2t-api/README.md +89 -0
- package/ondewo-csi-api/ondewo-t2s-api/README.md +89 -0
- package/package.json +49 -0
- package/public-api.d.ts +54 -0
package/index.d.ts
ADDED
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="https://www.ondewo.com">
|
|
3
|
+
<img alt="ONDEWO Logo" src="https://raw.githubusercontent.com/ondewo/ondewo-logos/master/github/ondewo_logo_github_2.png"/>
|
|
4
|
+
</a>
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
# ONDEWO CSI APIs
|
|
8
|
+
|
|
9
|
+
This repository contains the original interface definitions of public ONDEWO APIs that support gRPC protocols. Reading the original interface definitions can provide a better understanding of ONDEWO 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.
|
|
10
|
+
|
|
11
|
+
The core componenets of all the client libraries are built directly from files in this repo using [the proto compiler.](https://github.com/ondewo/ondewo-proto-compiler)
|
|
12
|
+
|
|
13
|
+
For an end-user, the APIS in this repo function mostly as documentation for the endpoints. For specific implementations, look in the following repos for working implementations:
|
|
14
|
+
* [Python](https://github.com/ondewo/ondewo-csi-client-python)
|
|
15
|
+
|
|
16
|
+
Please note that some of these implementations are works-in-progress. The repo will make clear the status of the implementation.
|
|
17
|
+
|
|
18
|
+
## Overview
|
|
19
|
+
|
|
20
|
+
ONDEWO APIs use [Protocol Buffers](https://github.com/google/protobuf) 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 gRPC versions of the API in all languages.
|
|
21
|
+
|
|
22
|
+
There are several ways of accessing APIs:
|
|
23
|
+
|
|
24
|
+
1. Protocol Buffers over gRPC: You can access APIs published in this repository through [GRPC](https://github.com/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.
|
|
25
|
+
|
|
26
|
+
2. ONDEWO Client Libraries:
|
|
27
|
+
You can use these libraries to access ONDEWO Cloud APIs. They are based on gRPC for better performance and provide idiomatic client surface for better developer experience.
|
|
28
|
+
|
|
29
|
+
## Discussions
|
|
30
|
+
|
|
31
|
+
Please use the issue tracker in this repo for discussions about this API, or the issue tracker in the relevant client if it is language-specific.
|
|
32
|
+
|
|
33
|
+
## Repository Structure
|
|
34
|
+
|
|
35
|
+
```
|
|
36
|
+
.
|
|
37
|
+
├── CONTRIBUTING.md
|
|
38
|
+
├── LICENSE
|
|
39
|
+
├── ondewo
|
|
40
|
+
│ ├── csi
|
|
41
|
+
│ │ ├── conversation.proto
|
|
42
|
+
├── README.md
|
|
43
|
+
└── RELEASE.md
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Generate gRPC Source Code
|
|
47
|
+
|
|
48
|
+
API client libraries can be built directly from files in this repo using [the proto compiler.](https://github.com/ondewo/ondewo-proto-compiler)
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
Automatic Release Process
|
|
52
|
+
------------------
|
|
53
|
+
The entire process is automated to make development easier. The actual steps are simple:
|
|
54
|
+
|
|
55
|
+
TODOs in Pull Request before the release:
|
|
56
|
+
|
|
57
|
+
- Update the Version number inside the Makefile
|
|
58
|
+
|
|
59
|
+
- Check if RELEASE.md is up-to-date
|
|
60
|
+
|
|
61
|
+
TODOs after Pull Request was merged in:
|
|
62
|
+
|
|
63
|
+
- Checkout master:
|
|
64
|
+
```bash
|
|
65
|
+
git checkout master
|
|
66
|
+
```
|
|
67
|
+
- Pull the new stuff:
|
|
68
|
+
```bash
|
|
69
|
+
git pull
|
|
70
|
+
```
|
|
71
|
+
- Release:
|
|
72
|
+
```bash
|
|
73
|
+
make ondewo_release
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
The ``` make ondewo_release``` command can be divided into 5 steps:
|
|
77
|
+
|
|
78
|
+
- cloning the devops-accounts repository and extracting the credentials
|
|
79
|
+
- creating and pushing the release branch
|
|
80
|
+
- creating and pushing the release tag
|
|
81
|
+
- creating the GitHub release
|
|
82
|
+
|
|
83
|
+
The variable for the GitHub Access Token is inside the Makefile,
|
|
84
|
+
but the value is overwritten during ``` make ondewo_release```, because
|
|
85
|
+
it is passed from the devops-accounts repo as an argument to the actual ```release``` command.
|
|
86
|
+
|
|
87
|
+
Proto Documentation
|
|
88
|
+
-------------------
|
|
89
|
+
|
|
90
|
+
Documentation for the .proto files is generated automatically when there is a pullrequest or push
|
|
91
|
+
to master. It is located in the branch [gh-pages](https://github.com/ondewo/ondewo-csi-api/tree/gh-pages).
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Google Ads API - proto definitions
|
|
2
|
+
|
|
3
|
+
This folder contains the [protocol
|
|
4
|
+
buffer](https://developers.google.com/protocol-buffers/) definitions for the
|
|
5
|
+
[Google Ads API](https://developers.google.com/google-ads/api/). To use this
|
|
6
|
+
API, we encourage you to take a look at our [official client
|
|
7
|
+
libraries](https://developers.google.com/google-ads/api/docs/client-libs) for
|
|
8
|
+
Java, Ruby, PHP, or .NET. Refer to the
|
|
9
|
+
[Quickstart](https://developers.google.com/google-ads/api/docs/first-call/overview)
|
|
10
|
+
to learn how to make your first API call.
|
|
11
|
+
|
|
12
|
+
To develop in a programming language without an official client library, refer
|
|
13
|
+
to the [API Concepts
|
|
14
|
+
Guide](https://developers.google.com/google-ads/api/docs/concepts/overview) and
|
|
15
|
+
consult these protocol buffer definitions as a reference when constructing API
|
|
16
|
+
requests.
|
|
17
|
+
|
|
18
|
+
Use [the official Google Ads API
|
|
19
|
+
forum](https://groups.google.com/d/forum/adwords-api) to request an official
|
|
20
|
+
client library in another programming language, report bugs, request new
|
|
21
|
+
features in the Google Ads API, or provide feedback.
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
Google Service Control provides control plane functionality to managed services,
|
|
2
|
+
such as logging, monitoring, and status checks. This page provides an overview
|
|
3
|
+
of what it does and how it works.
|
|
4
|
+
|
|
5
|
+
## Why use Service Control?
|
|
6
|
+
|
|
7
|
+
When you develop a cloud service, you typically start with the business
|
|
8
|
+
requirements and the architecture design, then proceed with API definition
|
|
9
|
+
and implementation. Before you put your service into production, you
|
|
10
|
+
need to deal with many control plane issues:
|
|
11
|
+
|
|
12
|
+
* How to control access to your service.
|
|
13
|
+
* How to send logging and monitoring data to both consumers and producers.
|
|
14
|
+
* How to create and manage dashboards to visualize this data.
|
|
15
|
+
* How to automatically scale the control plane components with your service.
|
|
16
|
+
|
|
17
|
+
Service Control is a mature and feature-rich control plane provider
|
|
18
|
+
that addresses these needs with high efficiency, high scalability,
|
|
19
|
+
and high availability. It provides a simple public API that can be accessed
|
|
20
|
+
from anywhere using JSON REST and gRPC clients, so when you move your service
|
|
21
|
+
from on-premise to a cloud provider, or from one cloud provider to another,
|
|
22
|
+
you don't need to change the control plane provider.
|
|
23
|
+
|
|
24
|
+
Services built using Google Cloud Endpoints already take advantage of
|
|
25
|
+
Service Control. Cloud Endpoints sends logging and monitoring data
|
|
26
|
+
through Google Service Control for every request arriving at its
|
|
27
|
+
proxy. If you need to report any additional logging and monitoring data for
|
|
28
|
+
your Cloud Endpoints service, you can call the Service Control API directly
|
|
29
|
+
from your service.
|
|
30
|
+
|
|
31
|
+
The Service Control API definition is open sourced and available on
|
|
32
|
+
[GitHub](https://github.com/googleapis/googleapis/tree/master/google/api/servicecontrol).
|
|
33
|
+
By changing the DNS name, you can easily use alternative implementations of
|
|
34
|
+
the Service Control API.
|
|
35
|
+
|
|
36
|
+
## Architecture
|
|
37
|
+
|
|
38
|
+
Google Service Control works with a set of *managed services* and their
|
|
39
|
+
*operations* (activities), *checks* whether an operation is allowed to proceed,
|
|
40
|
+
and *reports* completed operations. Behind the scenes, it leverages other
|
|
41
|
+
Google Cloud services, such as
|
|
42
|
+
[Google Service Management](/service-management),
|
|
43
|
+
[Stackdriver Logging](/logging), and [Stackdriver Monitoring](/monitoring),
|
|
44
|
+
while hiding their complexity from service producers. It enables service
|
|
45
|
+
producers to send telemetry data to their consumers. It uses caching,
|
|
46
|
+
batching, aggregation, and retries to deliver higher performance and
|
|
47
|
+
availability than the individual backend systems it encapsulates.
|
|
48
|
+
|
|
49
|
+
<figure id="fig-arch" class="center">
|
|
50
|
+
<div style="width: 70%;margin: auto">
|
|
51
|
+
<img src="/service-control/images/arch.svg"
|
|
52
|
+
alt="The overall architecture of a service that uses Google Service Control.">
|
|
53
|
+
</div>
|
|
54
|
+
<figcaption><b>Figure 1</b>: Using Google Service Control.</figcaption>
|
|
55
|
+
</figure>
|
|
56
|
+
|
|
57
|
+
The Service Control API provides two methods:
|
|
58
|
+
|
|
59
|
+
* [`services.check`](/service-control/reference/rest/v1/services/check), used for:
|
|
60
|
+
* Ensuring valid consumer status
|
|
61
|
+
* Validating API keys
|
|
62
|
+
* [`services.report`](/service-control/reference/rest/v1/services/report), used for:
|
|
63
|
+
* Sending logs to Stackdriver Logging
|
|
64
|
+
* Sending metrics to Stackdriver Monitoring
|
|
65
|
+
|
|
66
|
+
We’ll look at these in more detail in the rest of this overview.
|
|
67
|
+
|
|
68
|
+
## Managed services
|
|
69
|
+
|
|
70
|
+
A [managed service](/service-management/reference/rest/v1/services) is
|
|
71
|
+
a network service managed by
|
|
72
|
+
[Google Service Management](/service-management). Each managed service has a
|
|
73
|
+
unique name, such as `example.googleapis.com`, which must be a valid
|
|
74
|
+
fully-qualified DNS name, as per RFC 1035.
|
|
75
|
+
|
|
76
|
+
For example:
|
|
77
|
+
|
|
78
|
+
* Google Cloud Pub/Sub (`pubsub.googleapis.com`)
|
|
79
|
+
* Google Cloud Vision (`vision.googleapis.com`)
|
|
80
|
+
* Google Cloud Bigtable (`bigtable.googleapis.com`)
|
|
81
|
+
* Google Cloud Datastore (`datastore.googleapis.com`)
|
|
82
|
+
|
|
83
|
+
Google Service Management manages the lifecycle of each service’s
|
|
84
|
+
configuration, which is used to customize Google Service Control's behavior.
|
|
85
|
+
Service configurations are also used by Google Cloud Console
|
|
86
|
+
for displaying APIs and their settings, enabling/disabling APIs, and more.
|
|
87
|
+
|
|
88
|
+
## Operations
|
|
89
|
+
|
|
90
|
+
Google Service Control uses the generic concept of an *operation*
|
|
91
|
+
to represent the
|
|
92
|
+
activities of a managed service, such as API calls and resource usage. Each
|
|
93
|
+
operation is associated with a managed service and a specific service
|
|
94
|
+
consumer, and has a set of properties that describe the operation, such as
|
|
95
|
+
the API method name and resource usage amount. For more information, see the
|
|
96
|
+
[Operation definition](/service-control/rest/v1/Operation).
|
|
97
|
+
|
|
98
|
+
## Check
|
|
99
|
+
|
|
100
|
+
The [`services.check`](/service-control/reference/rest/v1/services/check)
|
|
101
|
+
method determines whether an operation should be allowed to proceed
|
|
102
|
+
for a managed service.
|
|
103
|
+
|
|
104
|
+
For example:
|
|
105
|
+
|
|
106
|
+
* Check if the consumer is still active.
|
|
107
|
+
* Check if the consumer has enabled the service.
|
|
108
|
+
* Check if the API key is still valid.
|
|
109
|
+
|
|
110
|
+
By performing multiple checks within a single method call, it provides
|
|
111
|
+
better performance, higher reliability, and reduced development cost to
|
|
112
|
+
service producers compared to checking with multiple backend systems.
|
|
113
|
+
|
|
114
|
+
## Report
|
|
115
|
+
|
|
116
|
+
The [`services.report`](/service-control/reference/rest/v1/services/report)
|
|
117
|
+
method reports completed operations for
|
|
118
|
+
a managed service to backend systems, such as logging and monitoring. The
|
|
119
|
+
reported data can be seen in Google API Console and Google Cloud Console,
|
|
120
|
+
and retrieved with appropriate APIs, such as the Stackdriver Logging and
|
|
121
|
+
Stackdriver Monitoring APIs.
|
|
122
|
+
|
|
123
|
+
## Next steps
|
|
124
|
+
|
|
125
|
+
* Read our [Getting Started guide](/service-control/getting-started) to find out
|
|
126
|
+
how to set up and use the Google Service Control API.
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
Google Service Management manages a set of *services*. Service
|
|
2
|
+
Management allows *service producers* to
|
|
3
|
+
publish their services on Google Cloud Platform so that they can be discovered
|
|
4
|
+
and used by *service consumers*. It also handles the tasks of tracking
|
|
5
|
+
service lifecycle and programming various backend systems -- such as
|
|
6
|
+
[Stackdriver Logging](https://cloud.google.com/stackdriver),
|
|
7
|
+
[Stackdriver Monitoring](https://cloud.google.com/stackdriver) -- to support
|
|
8
|
+
the managed services.
|
|
9
|
+
|
|
10
|
+
If you are a service producer, you can use the Google Service Management API
|
|
11
|
+
and [Google Cloud SDK (gcloud)](/sdk) to publish and manage your services.
|
|
12
|
+
Each managed service has a service configuration which declares various aspects
|
|
13
|
+
of the service such as its API surface, along with parameters to configure the
|
|
14
|
+
supporting backend
|
|
15
|
+
systems, such as logging and monitoring. If you build your service using
|
|
16
|
+
[Google Cloud Endpoints](https://cloud.google.com/endpoints/), the service
|
|
17
|
+
configuration will be handled automatically.
|
|
18
|
+
|
|
19
|
+
If you are a service consumer and want to use a managed service, you can use the
|
|
20
|
+
Google Service Management API or [Google Cloud Console](https://console.cloud.google.com)
|
|
21
|
+
to activate the
|
|
22
|
+
service for your [Google developer project](https://developers.google.com/console/help/new/),
|
|
23
|
+
then start using its APIs and functions.
|
|
24
|
+
|
|
25
|
+
## Managed services
|
|
26
|
+
|
|
27
|
+
REST URL: `https://servicemanagement.googleapis.com/v1/services/{service-name}` <br />
|
|
28
|
+
REST schema is defined [here](/service-management/reference/rest/v1/services).
|
|
29
|
+
|
|
30
|
+
A managed service refers to a network service managed by
|
|
31
|
+
Service Management. Each managed service has a unique name, such as
|
|
32
|
+
`example.googleapis.com`, which must be a valid fully-qualified DNS name, as per
|
|
33
|
+
RFC 1035.
|
|
34
|
+
|
|
35
|
+
A managed service typically provides some REST APIs and/or other
|
|
36
|
+
functions to their service consumers, such as mobile apps or cloud services.
|
|
37
|
+
|
|
38
|
+
Service producers can use methods, such as
|
|
39
|
+
[services.create](/service-management/reference/rest/v1/services/create),
|
|
40
|
+
[services.delete](/service-management/reference/rest/v1/services/delete),
|
|
41
|
+
[services.undelete](/service-management/reference/rest/v1/services/undelete),
|
|
42
|
+
to manipulate their managed services.
|
|
43
|
+
|
|
44
|
+
## Service producers
|
|
45
|
+
|
|
46
|
+
A service producer is the Google developer project responsible for publishing
|
|
47
|
+
and maintaining a managed service. Each managed service is owned by exactly one
|
|
48
|
+
service producer.
|
|
49
|
+
|
|
50
|
+
## Service consumers
|
|
51
|
+
|
|
52
|
+
A service consumer is a Google developer project that has enabled and can
|
|
53
|
+
invoke APIs on a managed service. A managed service can have many service
|
|
54
|
+
consumers.
|
|
55
|
+
|
|
56
|
+
## Service configuration
|
|
57
|
+
|
|
58
|
+
REST URL: `https://servicemanagement.googleapis.com/v1/services/{service-name}/configs/{config_id}` <br />
|
|
59
|
+
REST schema is defined [here](/service-management/reference/rest/v1/services.configs).
|
|
60
|
+
|
|
61
|
+
Each managed service is described by a service configuration which covers a wide
|
|
62
|
+
range of features, including its name, title, RPC API definitions,
|
|
63
|
+
REST API definitions, documentation, authentication, and more.
|
|
64
|
+
|
|
65
|
+
To change the configuration of a managed service, the service producer needs to
|
|
66
|
+
publish an updated service configuration to Service Management.
|
|
67
|
+
Service Management keeps a history of published
|
|
68
|
+
service configurations, making it possible to easily retrace how a service's
|
|
69
|
+
configuration evolved over time. Service configurations can be published using
|
|
70
|
+
the
|
|
71
|
+
[services.configs.create](/service-management/reference/rest/v1/services.configs/create)
|
|
72
|
+
or [services.configs.submit](/service-management/reference/rest/v1/services.configs/submit)
|
|
73
|
+
methods.
|
|
74
|
+
|
|
75
|
+
Alternatively, `services.configs.submit` allows publishing an
|
|
76
|
+
[OpenAPI](https://github.com/OAI/OpenAPI-Specification) specification, formerly
|
|
77
|
+
known as the Swagger Specification, which is automatically converted to a
|
|
78
|
+
corresponding service configuration.
|
|
79
|
+
|
|
80
|
+
## Service rollout
|
|
81
|
+
|
|
82
|
+
REST URL: `https://servicemanagement.googleapis.com/v1/services/{service-name}/rollouts/{rollout-id}` <br />
|
|
83
|
+
REST schema is defined [here](/service-management/reference/rest/v1/services.rollouts).
|
|
84
|
+
|
|
85
|
+
A `Rollout` defines how Google Service Management should deploy service
|
|
86
|
+
configurations to backend systems and how the configurations take effect at
|
|
87
|
+
runtime. It lets service producers specify multiple service configuration
|
|
88
|
+
versions to be deployed together, and a strategy that indicates how they
|
|
89
|
+
should be used.
|
|
90
|
+
|
|
91
|
+
Updating a managed service's configuration can be dangerous, as a configuration
|
|
92
|
+
error can lead to a service outage. To mitigate risks, Service Management
|
|
93
|
+
supports gradual rollout of service configuration changes. This feature gives
|
|
94
|
+
service producers time to identity potential issues and rollback service
|
|
95
|
+
configuration changes in case of errors, thus minimizing the customer
|
|
96
|
+
impact of bad configurations. For example, you could specify that 5% of traffic
|
|
97
|
+
uses configuration 1, while the remaining 95% uses configuration 2.
|
|
98
|
+
|
|
99
|
+
Service Management keeps a history of rollouts so that service
|
|
100
|
+
producers can undo to previous configuration versions. You can rollback a configuration
|
|
101
|
+
by initiating a new `Rollout` that clones a previously submitted
|
|
102
|
+
rollout record.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Google App Engine Admin API
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
|
|
5
|
+
The Google App Engine Admin API is a RESTful API for managing App Engine
|
|
6
|
+
applications. The Admin API provides programmatic access to several of the App
|
|
7
|
+
Engine administrative operations that are found in the
|
|
8
|
+
[Google Cloud Platform Console](https://cloud.google.com/appengine/docs/developers-console).
|
|
9
|
+
|
|
10
|
+
## Documentation
|
|
11
|
+
|
|
12
|
+
[Google App Engine Admin API Documentation](https://cloud.google.com/appengine/docs/admin-api/)
|
|
File without changes
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
[TOC]
|
|
2
|
+
|
|
3
|
+
# Introduction
|
|
4
|
+
|
|
5
|
+
The RuntimeConfig service provides Google Cloud Platform users the ability to
|
|
6
|
+
dynamically configure your service.
|
|
7
|
+
|
|
8
|
+
The RuntimConfig service creates and manages RuntimeConfig resources
|
|
9
|
+
within a Google Cloud Project and various variables within said resource.
|
|
10
|
+
|
|
11
|
+
## Details
|
|
12
|
+
|
|
13
|
+
Each cloud project can create multiple **Config** objects. A **Config** object
|
|
14
|
+
by itself does not contain any configuration information, but rather is a
|
|
15
|
+
logical grouping of variables. Variable names are hierarchical and follow file
|
|
16
|
+
system style, where only leaf nodes can contain values.
|
|
17
|
+
|
|
18
|
+
For example, you can have a configuration called *Flags*. Within that
|
|
19
|
+
configuration object, you can create the following variables.
|
|
20
|
+
|
|
21
|
+
* `/ports/service_port`
|
|
22
|
+
* `/ports/monitoring_port`
|
|
23
|
+
* `/ports/admin_port`
|
|
24
|
+
|
|
25
|
+
This creates three variables: `/ports/serve_port`, `/ports/monitoring_port`,
|
|
26
|
+
`/ports/admin_port`. Note that `/ports` cannot have a value but it can be
|
|
27
|
+
listed.
|
|
28
|
+
|
|
29
|
+
### Setup
|
|
30
|
+
|
|
31
|
+
In order to make requests to RuntimeConfig service, you need to enable the API
|
|
32
|
+
for your project.
|
|
33
|
+
|
|
34
|
+
To achieve that, go to the
|
|
35
|
+
[Google Cloud Console](https://console.cloud.google.com/apis/api/runtimeconfig.googleapis.com/overview)
|
|
36
|
+
and enable *Google Cloud RuntimeConfig API* for your project.
|
|
37
|
+
|
|
38
|
+
The documentation for this service is located
|
|
39
|
+
[here](https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/).
|
|
File without changes
|
|
File without changes
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
The Google Cloud Container Builder API lets you to build an application or part of an application from source code stored in Google Cloud Storage or a Google Cloud Source Repository and package it into container images. The container images are then stored in Google Container Registry. You can optionally copy the images to another container registry as required.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
Read more about the Stackdriver Error Reporting API [here](https://cloud.google.com/error-reporting/reference/)
|
|
File without changes
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
Stores, processes, explores and shares genomic data. This API implements
|
|
2
|
+
the Global Alliance for Genomics and Health (GA4GH) v0.5.1 API as well as
|
|
3
|
+
several extensions.
|
|
4
|
+
|
|
5
|
+
The Google Genomics API supports access via both
|
|
6
|
+
[JSON/REST](https://cloud.google.com/genomics/reference/rest) and
|
|
7
|
+
[gRPC](https://cloud.google.com/genomics/reference/rpc). JSON/REST is more
|
|
8
|
+
broadly available and is easier for getting started with Google Genomics; it
|
|
9
|
+
works well for small metadata resources (datasets, variant sets, read group
|
|
10
|
+
sets) and for browsing small genomic regions for datasets of any size. For
|
|
11
|
+
performant bulk data access (reads and variants), use gRPC.
|
|
12
|
+
|
|
13
|
+
See also an [overview of genomic resources](https://cloud.google.com/genomics/v1/users-guide)
|
|
14
|
+
and an overview of [Genomics on Google Cloud](https://cloud.google.com/genomics/overview).
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Introduction
|
|
2
|
+
|
|
3
|
+
# Key Concepts
|
|
4
|
+
|
|
5
|
+
## Service Account
|
|
6
|
+
|
|
7
|
+
A Service Account is an account used to identify services (non-humans) to Google.
|
|
8
|
+
A Service Account has a list of Service Account Keys, which can be used to authenticate to Google.
|
|
9
|
+
|
|
10
|
+
## Service Account Keys
|
|
11
|
+
|
|
12
|
+
A Service Account Key is a public/private keypair generated by Google. Google retains the public
|
|
13
|
+
key, while the customer is given the private key. The private key can be used to [sign JWTs and
|
|
14
|
+
authenticate Service Accounts to Google](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#authorizingrequests).
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
## Overview
|
|
2
|
+
This file describes an API for a Pub/Sub (Publish/Subscribe) system. This system
|
|
3
|
+
provides a reliable many-to-many communication mechanism between independently
|
|
4
|
+
written publishers and subscribers where the publisher publishes messages to
|
|
5
|
+
*topics* and each subscriber creates a *subscription* and consumes *messages*
|
|
6
|
+
from it.
|
|
7
|
+
|
|
8
|
+
1. The Pub/Sub system maintains bindings between topics and subscriptions.
|
|
9
|
+
2. A publisher publishes messages into a topic.
|
|
10
|
+
3. The Pub/Sub system delivers messages from topics into attached
|
|
11
|
+
subscriptions.
|
|
12
|
+
4. A subscriber receives pending messages from its subscription and
|
|
13
|
+
acknowledges each one to the Pub/Sub system.
|
|
14
|
+
5. The Pub/Sub system removes acknowledged messages from that subscription.
|
|
15
|
+
|
|
16
|
+
## Data Model
|
|
17
|
+
The data model consists of the following:
|
|
18
|
+
|
|
19
|
+
* **Topic**: A topic is a resource to which messages are published by
|
|
20
|
+
publishers. Topics are named, and the name of the topic is unique within the
|
|
21
|
+
Pub/Sub system.
|
|
22
|
+
|
|
23
|
+
* **Subscription**: A subscription records the subscriber's interest in a
|
|
24
|
+
topic. The Pub/Sub system maintains those messages which still need
|
|
25
|
+
to be delivered and acknowledged so that they can retried as needed.
|
|
26
|
+
The set of messages that have not been acknowledged is called the
|
|
27
|
+
subscription backlog.
|
|
28
|
+
|
|
29
|
+
* **Message**: A message is a unit of data that flows in the system. It
|
|
30
|
+
contains opaque data from the publisher along with its *attributes*.
|
|
31
|
+
|
|
32
|
+
* **Message Attributes** (optional): A set of opaque key-value pairs assigned
|
|
33
|
+
by the publisher to a message. Attributes are delivered unmodified to
|
|
34
|
+
subscribers together with the message data, if there's any.
|
|
35
|
+
|
|
36
|
+
## Publisher Flow
|
|
37
|
+
A publisher publishes messages to the topic using the `Publish` call:
|
|
38
|
+
|
|
39
|
+
```data
|
|
40
|
+
PubsubMessage message;
|
|
41
|
+
message.set_data("....");
|
|
42
|
+
message.attributes.put("key1", "value1");
|
|
43
|
+
PublishRequest request;
|
|
44
|
+
request.set_topic("topicName");
|
|
45
|
+
request.add_message(message);
|
|
46
|
+
Publisher.Publish(request);
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Subscriber Flow
|
|
50
|
+
The subscriber part of the API is richer than the publisher part and has a
|
|
51
|
+
number of concepts for subscription creation and use:
|
|
52
|
+
|
|
53
|
+
1. A subscriber (user or process) creates a subscription using the
|
|
54
|
+
`CreateSubscription` call.
|
|
55
|
+
|
|
56
|
+
2. A subscriber receives messages in one of two ways: via pull or push.
|
|
57
|
+
|
|
58
|
+
* To receive messages via pull, a subscriber calls the `Pull` method on the
|
|
59
|
+
`Subscriber` to get messages from the subscription. For each individual
|
|
60
|
+
message, the subscriber may use the `ack_id` received in the
|
|
61
|
+
`PullResponse` to `Acknowledge` the message, or modify the *ack deadline*
|
|
62
|
+
with `ModifyAckDeadline`. See the `Subscription.ack_deadline_seconds`
|
|
63
|
+
field documentation for details on the ack deadline behavior. Messages
|
|
64
|
+
must be acknowledged or they will be redelivered in a future `Pull` call.
|
|
65
|
+
|
|
66
|
+
**Note:** Messages may be consumed in parallel by multiple processes
|
|
67
|
+
making `Pull` calls to the same subscription; this will result in the set
|
|
68
|
+
of messages from the subscription being split among the processes, each
|
|
69
|
+
process receiving a subset of the messages.
|
|
70
|
+
|
|
71
|
+
* To receive messages via push, the `PushConfig` field must be specified in
|
|
72
|
+
the `Subscription` parameter when creating a subscription, or set with
|
|
73
|
+
`ModifyPushConfig`. The PushConfig specifies an endpoint at which the
|
|
74
|
+
subscriber exposes the `PushEndpointService` or some other handler,
|
|
75
|
+
depending on the endpoint. Messages are received via the
|
|
76
|
+
`ProcessPushMessage` method. The push subscriber responds to the method
|
|
77
|
+
with a result code that indicates one of three things: `Acknowledge` (the
|
|
78
|
+
message has been successfully processed and the Pub/Sub system may delete
|
|
79
|
+
it), `Nack` (the message has been rejected and the Pub/Sub system should
|
|
80
|
+
resend it at a later time).
|
|
81
|
+
|
|
82
|
+
**Note:** The endpoint may be a load balancer for better scalability, so
|
|
83
|
+
that multiple processes may handle the message processing load.
|
|
84
|
+
|
|
85
|
+
Subscription creation:
|
|
86
|
+
|
|
87
|
+
```data
|
|
88
|
+
Subscription subscription;
|
|
89
|
+
subscription.set_topic("topicName");
|
|
90
|
+
subscription.set_name("subscriptionName");
|
|
91
|
+
subscription.push_config().set_push_endpoint("machinename:8888");
|
|
92
|
+
Subscriber.CreateSubscription(subscription);
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Consuming messages via pull:
|
|
96
|
+
|
|
97
|
+
```data
|
|
98
|
+
// The subscription must be created without setting the push_config field.
|
|
99
|
+
|
|
100
|
+
PullRequest pull_request;
|
|
101
|
+
pull_request.set_subscription("subscriptionName");
|
|
102
|
+
pull_request.set_return_immediately(false);
|
|
103
|
+
pull_request.set_max_messages(10);
|
|
104
|
+
while (true) {
|
|
105
|
+
PullResponse pull_response;
|
|
106
|
+
AcknowledgeRequest ack_request;
|
|
107
|
+
ackRequest.set_subscription("subscriptionName");
|
|
108
|
+
if (Subscriber.Pull(pull_request, pull_response) == OK) {
|
|
109
|
+
for (ReceivedMessage received in pull_response.received_messages()) {
|
|
110
|
+
Process(received.message().data());
|
|
111
|
+
ackRequest.add_ack_id(received.ack_id());
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
if (ackRequest.ack_ids().size() > 0) {
|
|
115
|
+
Subscriber.Acknowledge(ack_request);
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
## Reliability Semantics
|
|
121
|
+
When a subscriber successfully creates a subscription using
|
|
122
|
+
`Subscriber.CreateSubscription`, it establishes a "subscription point" for
|
|
123
|
+
that subscription, no later than the time that `Subscriber.CreateSubscription`
|
|
124
|
+
returns. The subscriber is guaranteed to receive any message published after
|
|
125
|
+
this subscription point. Note that messages published before the subscription
|
|
126
|
+
point may or may not be delivered.
|
|
127
|
+
|
|
128
|
+
Messages are not delivered in any particular order by the Pub/Sub system.
|
|
129
|
+
Furthermore, the system guarantees *at-least-once* delivery of each message
|
|
130
|
+
until acknowledged.
|
|
131
|
+
|
|
132
|
+
## Deletion
|
|
133
|
+
Both topics and subscriptions may be deleted.
|
|
134
|
+
|
|
135
|
+
When a subscription is deleted, all messages are immediately dropped. If it
|
|
136
|
+
is a pull subscriber, future pull requests will return NOT_FOUND.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
An API to contribute 360 photos to Google Street View. The API also allows the users to connect photos, update metadata of the photos, generate photo collections, and delete photos.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Google Common Types
|
|
2
|
+
|
|
3
|
+
This package contains definitions of common types for Google APIs.
|
|
4
|
+
All types defined in this package are suitable for different APIs to
|
|
5
|
+
exchange data, and will never break binary compatibility. They should
|
|
6
|
+
have design quality comparable to major programming languages like
|
|
7
|
+
Java and C#.
|
|
8
|
+
|
|
9
|
+
NOTE: Some common types are defined in the package `google.protobuf`
|
|
10
|
+
as they are directly supported by Protocol Buffers compiler and
|
|
11
|
+
runtime. Those types are called Well-Known Types.
|
|
12
|
+
|
|
13
|
+
## Java Utilities
|
|
14
|
+
|
|
15
|
+
A set of Java utilities for the Common Types are provided in the
|
|
16
|
+
`//java/com/google/type/util/` package.
|