/** * Copyright 2019 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import { GaxiosPromise } from 'gaxios'; import { Compute, JWT, OAuth2Client, UserRefreshClient } from 'google-auth-library'; import { BodyResponseCallback, GlobalOptions, GoogleConfigurable, MethodOptions } from 'googleapis-common'; export declare namespace pubsub_v1beta2 { interface Options extends GlobalOptions { version: 'v1beta2'; } interface StandardParameters { /** * V1 error format. */ '$.xgafv'?: string; /** * OAuth access token. */ access_token?: string; /** * Data format for response. */ alt?: string; /** * JSONP */ callback?: string; /** * Selector specifying which fields to include in a partial response. */ fields?: string; /** * API key. Your API key identifies your project and provides you with API * access, quota, and reports. Required unless you provide an OAuth 2.0 * token. */ key?: string; /** * OAuth 2.0 token for the current user. */ oauth_token?: string; /** * Returns response with indentations and line breaks. */ prettyPrint?: boolean; /** * Available to use for quota purposes for server-side applications. Can be * any arbitrary string assigned to a user, but should not exceed 40 * characters. */ quotaUser?: string; /** * Legacy upload protocol for media (e.g. "media", "multipart"). */ uploadType?: string; /** * Upload protocol for media (e.g. "raw", "multipart"). */ upload_protocol?: string; } /** * Cloud Pub/Sub API * * Provides reliable, many-to-many, asynchronous messaging between * applications. * * @example * const {google} = require('googleapis'); * const pubsub = google.pubsub('v1beta2'); * * @namespace pubsub * @type {Function} * @version v1beta2 * @variation v1beta2 * @param {object=} options Options for Pubsub */ class Pubsub { projects: Resource$Projects; constructor(options: GlobalOptions, google?: GoogleConfigurable); } /** * Request for the Acknowledge method. */ interface Schema$AcknowledgeRequest { /** * The acknowledgment ID for the messages being acknowledged that was * returned by the Pub/Sub system in the `Pull` response. Must not be empty. */ ackIds?: string[]; } /** * Associates `members` with a `role`. */ interface Schema$Binding { /** * Unimplemented. The condition that is associated with this binding. NOTE: * an unsatisfied condition will not allow user access via current binding. * Different bindings, including their conditions, are examined * independently. */ condition?: Schema$Expr; /** * Specifies the identities requesting access for a Cloud Platform resource. * `members` can have the following values: * `allUsers`: A special * identifier that represents anyone who is on the internet; with or * without a Google account. * `allAuthenticatedUsers`: A special * identifier that represents anyone who is authenticated with a Google * account or a service account. * `user:{emailid}`: An email address that * represents a specific Google account. For example, `alice@gmail.com` . * * `serviceAccount:{emailid}`: An email address that represents a service * account. For example, `my-other-app@appspot.gserviceaccount.com`. * * `group:{emailid}`: An email address that represents a Google group. For * example, `admins@example.com`. * `domain:{domain}`: A Google Apps * domain name that represents all the users of that domain. For example, * `google.com` or `example.com`. */ members?: string[]; /** * Role that is assigned to `members`. For example, `roles/viewer`, * `roles/editor`, or `roles/owner`. */ role?: string; } /** * A generic empty message that you can re-use to avoid defining duplicated * empty messages in your APIs. A typical example is to use it as the request * or the response type of an API method. For instance: service Foo { rpc * Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON * representation for `Empty` is empty JSON object `{}`. */ interface Schema$Empty { } /** * Represents an expression text. Example: title: "User account * presence" description: "Determines whether the request has a * user account" expression: "size(request.user) > 0" */ interface Schema$Expr { /** * An optional description of the expression. This is a longer text which * describes the expression, e.g. when hovered over it in a UI. */ description?: string; /** * Textual representation of an expression in Common Expression Language * syntax. The application context of the containing message determines * which well-known feature set of CEL is supported. */ expression?: string; /** * An optional string indicating the location of the expression for error * reporting, e.g. a file name and a position in the file. */ location?: string; /** * An optional title for the expression, i.e. a short string describing its * purpose. This can be used e.g. in UIs which allow to enter the * expression. */ title?: string; } /** * Response for the `ListSubscriptions` method. */ interface Schema$ListSubscriptionsResponse { /** * If not empty, indicates that there may be more subscriptions that match * the request; this value should be passed in a new * `ListSubscriptionsRequest` to get more subscriptions. */ nextPageToken?: string; /** * The subscriptions that match the request. */ subscriptions?: Schema$Subscription[]; } /** * Response for the `ListTopics` method. */ interface Schema$ListTopicsResponse { /** * If not empty, indicates that there may be more topics that match the * request; this value should be passed in a new `ListTopicsRequest`. */ nextPageToken?: string; /** * The resulting topics. */ topics?: Schema$Topic[]; } /** * Response for the `ListTopicSubscriptions` method. */ interface Schema$ListTopicSubscriptionsResponse { /** * If not empty, indicates that there may be more subscriptions that match * the request; this value should be passed in a new * `ListTopicSubscriptionsRequest` to get more subscriptions. */ nextPageToken?: string; /** * The names of the subscriptions that match the request. */ subscriptions?: string[]; } /** * Request for the ModifyAckDeadline method. */ interface Schema$ModifyAckDeadlineRequest { /** * The new ack deadline with respect to the time this request was sent to * the Pub/Sub system. Must be >= 0. For example, if the value is 10, the * new ack deadline will expire 10 seconds after the `ModifyAckDeadline` * call was made. Specifying zero may immediately make the message available * for another pull request. */ ackDeadlineSeconds?: number; /** * The acknowledgment ID. Either this or ack_ids must be populated, but not * both. */ ackId?: string; /** * List of acknowledgment IDs. */ ackIds?: string[]; } /** * Request for the ModifyPushConfig method. */ interface Schema$ModifyPushConfigRequest { /** * The push configuration for future deliveries. An empty `pushConfig` * indicates that the Pub/Sub system should stop pushing messages from the * given subscription and allow messages to be pulled and acknowledged - * effectively pausing the subscription if `Pull` is not called. */ pushConfig?: Schema$PushConfig; } /** * Defines an Identity and Access Management (IAM) policy. It is used to * specify access control policies for Cloud Platform resources. A `Policy` * consists of a list of `bindings`. A `binding` binds a list of `members` to * a `role`, where the members can be user accounts, Google groups, Google * domains, and service accounts. A `role` is a named list of permissions * defined by IAM. **JSON Example** { "bindings": [ { * "role": "roles/owner", "members": [ * "user:mike@example.com", "group:admins@example.com", * "domain:google.com", * "serviceAccount:my-other-app@appspot.gserviceaccount.com" ] }, { * "role": "roles/viewer", "members": * ["user:sean@example.com"] } ] } **YAML * Example** bindings: - members: - user:mike@example.com - * group:admins@example.com - domain:google.com - * serviceAccount:my-other-app@appspot.gserviceaccount.com role: * roles/owner - members: - user:sean@example.com role: * roles/viewer For a description of IAM and its features, see the [IAM * developer's guide](https://cloud.google.com/iam/docs). */ interface Schema$Policy { /** * Associates a list of `members` to a `role`. `bindings` with no members * will result in an error. */ bindings?: Schema$Binding[]; /** * `etag` is used for optimistic concurrency control as a way to help * prevent simultaneous updates of a policy from overwriting each other. It * is strongly suggested that systems make use of the `etag` in the * read-modify-write cycle to perform policy updates in order to avoid race * conditions: An `etag` is returned in the response to `getIamPolicy`, and * systems are expected to put that etag in the request to `setIamPolicy` to * ensure that their change will be applied to the same version of the * policy. If no `etag` is provided in the call to `setIamPolicy`, then the * existing policy is overwritten blindly. */ etag?: string; /** * Deprecated. */ version?: number; } /** * Request for the Publish method. */ interface Schema$PublishRequest { /** * The messages to publish. */ messages?: Schema$PubsubMessage[]; } /** * Response for the `Publish` method. */ interface Schema$PublishResponse { /** * The server-assigned ID of each published message, in the same order as * the messages in the request. IDs are guaranteed to be unique within the * topic. */ messageIds?: string[]; } /** * A message data and its attributes. The message payload must not be empty; * it must contain either a non-empty data field, or at least one attribute. */ interface Schema$PubsubMessage { /** * Optional attributes for this message. */ attributes?: { [key: string]: string; }; /** * The message payload. For JSON requests, the value of this field must be * [base64-encoded](https://tools.ietf.org/html/rfc4648). */ data?: string; /** * ID of this message, assigned by the server when the message is published. * Guaranteed to be unique within the topic. This value may be read by a * subscriber that receives a `PubsubMessage` via a `Pull` call or a push * delivery. It must not be populated by the publisher in a `Publish` call. */ messageId?: string; /** * The time at which the message was published, populated by the server when * it receives the `Publish` call. It must not be populated by the publisher * in a `Publish` call. */ publishTime?: string; } /** * Request for the `Pull` method. */ interface Schema$PullRequest { /** * The maximum number of messages returned for this request. The Pub/Sub * system may return fewer than the number specified. */ maxMessages?: number; /** * If this is specified as true the system will respond immediately even if * it is not able to return a message in the `Pull` response. Otherwise the * system is allowed to wait until at least one message is available rather * than returning no messages. The client may cancel the request if it does * not wish to wait any longer for the response. */ returnImmediately?: boolean; } /** * Response for the `Pull` method. */ interface Schema$PullResponse { /** * Received Pub/Sub messages. The Pub/Sub system will return zero messages * if there are no more available in the backlog. The Pub/Sub system may * return fewer than the `maxMessages` requested even if there are more * messages available in the backlog. */ receivedMessages?: Schema$ReceivedMessage[]; } /** * Configuration for a push delivery endpoint. */ interface Schema$PushConfig { /** * Endpoint configuration attributes. Every endpoint has a set of API * supported attributes that can be used to control different aspects of the * message delivery. The currently supported attribute is `x-goog-version`, * which you can use to change the format of the push message. This * attribute indicates the version of the data expected by the endpoint. * This controls the shape of the envelope (i.e. its fields and metadata). * The endpoint version is based on the version of the Pub/Sub API. If not * present during the `CreateSubscription` call, it will default to the * version of the API used to make such call. If not present during a * `ModifyPushConfig` call, its value will not be changed. `GetSubscription` * calls will always return a valid version, even if the subscription was * created without this attribute. The possible values for this attribute * are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub * API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub * API. */ attributes?: { [key: string]: string; }; /** * A URL locating the endpoint to which messages should be pushed. For * example, a Webhook endpoint might use * "https://example.com/push". */ pushEndpoint?: string; } /** * A message and its corresponding acknowledgment ID. */ interface Schema$ReceivedMessage { /** * This ID can be used to acknowledge the received message. */ ackId?: string; /** * The message. */ message?: Schema$PubsubMessage; } /** * Request message for `SetIamPolicy` method. */ interface Schema$SetIamPolicyRequest { /** * REQUIRED: The complete policy to be applied to the `resource`. The size * of the policy is limited to a few 10s of KB. An empty policy is a valid * policy but certain Cloud Platform services (such as Projects) might * reject them. */ policy?: Schema$Policy; } /** * A subscription resource. */ interface Schema$Subscription { /** * This value is the maximum time after a subscriber receives a message * before the subscriber should acknowledge the message. After message * delivery but before the ack deadline expires and before the message is * acknowledged, it is an outstanding message and will not be delivered * again during that time (on a best-effort basis). For pull subscriptions, * this value is used as the initial value for the ack deadline. To override * this value for a given message, call `ModifyAckDeadline` with the * corresponding `ack_id` if using pull. The maximum custom deadline you can * specify is 600 seconds (10 minutes). For push delivery, this value is * also used to set the request timeout for the call to the push endpoint. * If the subscriber never acknowledges the message, the Pub/Sub system will * eventually redeliver the message. If this parameter is 0, a default * value of 10 seconds is used. */ ackDeadlineSeconds?: number; /** * The name of the subscription. It must have the format * `"projects/{project}/subscriptions/{subscription}"`. * `{subscription}` must start with a letter, and contain only letters * (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods * (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be * between 3 and 255 characters in length, and it must not start with * `"goog"`. */ name?: string; /** * If push delivery is used with this subscription, this field is used to * configure it. An empty `pushConfig` signifies that the subscriber will * pull and ack messages using API methods. */ pushConfig?: Schema$PushConfig; /** * The name of the topic from which this subscription is receiving messages. * The value of this field will be `_deleted-topic_` if the topic has been * deleted. */ topic?: string; } /** * Request message for `TestIamPermissions` method. */ interface Schema$TestIamPermissionsRequest { /** * The set of permissions to check for the `resource`. Permissions with * wildcards (such as '*' or 'storage.*') are not allowed. * For more information see [IAM * Overview](https://cloud.google.com/iam/docs/overview#permissions). */ permissions?: string[]; } /** * Response message for `TestIamPermissions` method. */ interface Schema$TestIamPermissionsResponse { /** * A subset of `TestPermissionsRequest.permissions` that the caller is * allowed. */ permissions?: string[]; } /** * A topic resource. */ interface Schema$Topic { /** * The name of the topic. It must have the format * `"projects/{project}/topics/{topic}"`. `{topic}` must start * with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), * dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) * or percent signs (`%`). It must be between 3 and 255 characters in * length, and it must not start with `"goog"`. */ name?: string; } class Resource$Projects { subscriptions: Resource$Projects$Subscriptions; topics: Resource$Projects$Topics; constructor(); } class Resource$Projects$Subscriptions { constructor(); /** * pubsub.projects.subscriptions.acknowledge * @desc Acknowledges the messages associated with the `ack_ids` in the * `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages * from the subscription. Acknowledging a message whose ack deadline has * expired may succeed, but such a message may be redelivered later. * Acknowledging a message more than once will not result in an error. * @alias pubsub.projects.subscriptions.acknowledge * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.subscription The subscription whose message is being acknowledged. * @param {().AcknowledgeRequest} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ acknowledge(params?: Params$Resource$Projects$Subscriptions$Acknowledge, options?: MethodOptions): GaxiosPromise; acknowledge(params: Params$Resource$Projects$Subscriptions$Acknowledge, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; acknowledge(params: Params$Resource$Projects$Subscriptions$Acknowledge, callback: BodyResponseCallback): void; acknowledge(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.create * @desc Creates a subscription to a given topic. If the subscription * already exists, returns `ALREADY_EXISTS`. If the corresponding topic * doesn't exist, returns `NOT_FOUND`. If the name is not provided in the * request, the server will assign a random name for this subscription on * the same project as the topic. Note that for REST API requests, you must * specify a name. * @alias pubsub.projects.subscriptions.create * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.name The name of the subscription. It must have the format `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`. * @param {().Subscription} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ create(params?: Params$Resource$Projects$Subscriptions$Create, options?: MethodOptions): GaxiosPromise; create(params: Params$Resource$Projects$Subscriptions$Create, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; create(params: Params$Resource$Projects$Subscriptions$Create, callback: BodyResponseCallback): void; create(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.delete * @desc Deletes an existing subscription. All pending messages in the * subscription are immediately dropped. Calls to `Pull` after deletion will * return `NOT_FOUND`. After a subscription is deleted, a new one may be * created with the same name, but the new one has no association with the * old subscription, or its topic unless the same topic is specified. * @alias pubsub.projects.subscriptions.delete * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.subscription The subscription to delete. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ delete(params?: Params$Resource$Projects$Subscriptions$Delete, options?: MethodOptions): GaxiosPromise; delete(params: Params$Resource$Projects$Subscriptions$Delete, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; delete(params: Params$Resource$Projects$Subscriptions$Delete, callback: BodyResponseCallback): void; delete(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.get * @desc Gets the configuration details of a subscription. * @alias pubsub.projects.subscriptions.get * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.subscription The name of the subscription to get. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ get(params?: Params$Resource$Projects$Subscriptions$Get, options?: MethodOptions): GaxiosPromise; get(params: Params$Resource$Projects$Subscriptions$Get, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; get(params: Params$Resource$Projects$Subscriptions$Get, callback: BodyResponseCallback): void; get(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.getIamPolicy * @desc Gets the access control policy for a resource. Returns an empty * policy if the resource exists and does not have a policy set. * @alias pubsub.projects.subscriptions.getIamPolicy * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.resource_ REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ getIamPolicy(params?: Params$Resource$Projects$Subscriptions$Getiampolicy, options?: MethodOptions): GaxiosPromise; getIamPolicy(params: Params$Resource$Projects$Subscriptions$Getiampolicy, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; getIamPolicy(params: Params$Resource$Projects$Subscriptions$Getiampolicy, callback: BodyResponseCallback): void; getIamPolicy(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.list * @desc Lists matching subscriptions. * @alias pubsub.projects.subscriptions.list * @memberOf! () * * @param {object} params Parameters for request * @param {integer=} params.pageSize Maximum number of subscriptions to return. * @param {string=} params.pageToken The value returned by the last `ListSubscriptionsResponse`; indicates that this is a continuation of a prior `ListSubscriptions` call, and that the system should return the next page of data. * @param {string} params.project The name of the cloud project that subscriptions belong to. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ list(params?: Params$Resource$Projects$Subscriptions$List, options?: MethodOptions): GaxiosPromise; list(params: Params$Resource$Projects$Subscriptions$List, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; list(params: Params$Resource$Projects$Subscriptions$List, callback: BodyResponseCallback): void; list(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.modifyAckDeadline * @desc Modifies the ack deadline for a specific message. This method is * useful to indicate that more time is needed to process a message by the * subscriber, or to make the message available for redelivery if the * processing was interrupted. Note that this does not modify the * subscription-level `ackDeadlineSeconds` used for subsequent messages. * @alias pubsub.projects.subscriptions.modifyAckDeadline * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.subscription The name of the subscription. * @param {().ModifyAckDeadlineRequest} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ modifyAckDeadline(params?: Params$Resource$Projects$Subscriptions$Modifyackdeadline, options?: MethodOptions): GaxiosPromise; modifyAckDeadline(params: Params$Resource$Projects$Subscriptions$Modifyackdeadline, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; modifyAckDeadline(params: Params$Resource$Projects$Subscriptions$Modifyackdeadline, callback: BodyResponseCallback): void; modifyAckDeadline(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.modifyPushConfig * @desc Modifies the `PushConfig` for a specified subscription. This may * be used to change a push subscription to a pull one (signified by an * empty `PushConfig`) or vice versa, or change the endpoint URL and other * attributes of a push subscription. Messages will accumulate for delivery * continuously through the call regardless of changes to the `PushConfig`. * @alias pubsub.projects.subscriptions.modifyPushConfig * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.subscription The name of the subscription. * @param {().ModifyPushConfigRequest} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ modifyPushConfig(params?: Params$Resource$Projects$Subscriptions$Modifypushconfig, options?: MethodOptions): GaxiosPromise; modifyPushConfig(params: Params$Resource$Projects$Subscriptions$Modifypushconfig, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; modifyPushConfig(params: Params$Resource$Projects$Subscriptions$Modifypushconfig, callback: BodyResponseCallback): void; modifyPushConfig(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.pull * @desc Pulls messages from the server. Returns an empty list if there are * no messages available in the backlog. The server may return `UNAVAILABLE` * if there are too many concurrent pull requests pending for the given * subscription. * @alias pubsub.projects.subscriptions.pull * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.subscription The subscription from which messages should be pulled. * @param {().PullRequest} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ pull(params?: Params$Resource$Projects$Subscriptions$Pull, options?: MethodOptions): GaxiosPromise; pull(params: Params$Resource$Projects$Subscriptions$Pull, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; pull(params: Params$Resource$Projects$Subscriptions$Pull, callback: BodyResponseCallback): void; pull(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.setIamPolicy * @desc Sets the access control policy on the specified resource. Replaces * any existing policy. * @alias pubsub.projects.subscriptions.setIamPolicy * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.resource_ REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. * @param {().SetIamPolicyRequest} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ setIamPolicy(params?: Params$Resource$Projects$Subscriptions$Setiampolicy, options?: MethodOptions): GaxiosPromise; setIamPolicy(params: Params$Resource$Projects$Subscriptions$Setiampolicy, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; setIamPolicy(params: Params$Resource$Projects$Subscriptions$Setiampolicy, callback: BodyResponseCallback): void; setIamPolicy(callback: BodyResponseCallback): void; /** * pubsub.projects.subscriptions.testIamPermissions * @desc Returns permissions that a caller has on the specified resource. If * the resource does not exist, this will return an empty set of * permissions, not a NOT_FOUND error. Note: This operation is designed to * be used for building permission-aware UIs and command-line tools, not for * authorization checking. This operation may "fail open" without warning. * @alias pubsub.projects.subscriptions.testIamPermissions * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.resource_ REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. * @param {().TestIamPermissionsRequest} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ testIamPermissions(params?: Params$Resource$Projects$Subscriptions$Testiampermissions, options?: MethodOptions): GaxiosPromise; testIamPermissions(params: Params$Resource$Projects$Subscriptions$Testiampermissions, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; testIamPermissions(params: Params$Resource$Projects$Subscriptions$Testiampermissions, callback: BodyResponseCallback): void; testIamPermissions(callback: BodyResponseCallback): void; } interface Params$Resource$Projects$Subscriptions$Acknowledge extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The subscription whose message is being acknowledged. */ subscription?: string; /** * Request body metadata */ requestBody?: Schema$AcknowledgeRequest; } interface Params$Resource$Projects$Subscriptions$Create extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The name of the subscription. It must have the format * `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` * must start with a letter, and contain only letters (`[A-Za-z]`), numbers * (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), * plus (`+`) or percent signs (`%`). It must be between 3 and 255 * characters in length, and it must not start with `"goog"`. */ name?: string; /** * Request body metadata */ requestBody?: Schema$Subscription; } interface Params$Resource$Projects$Subscriptions$Delete extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The subscription to delete. */ subscription?: string; } interface Params$Resource$Projects$Subscriptions$Get extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The name of the subscription to get. */ subscription?: string; } interface Params$Resource$Projects$Subscriptions$Getiampolicy extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * REQUIRED: The resource for which the policy is being requested. See the * operation documentation for the appropriate value for this field. */ resource?: string; } interface Params$Resource$Projects$Subscriptions$List extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * Maximum number of subscriptions to return. */ pageSize?: number; /** * The value returned by the last `ListSubscriptionsResponse`; indicates * that this is a continuation of a prior `ListSubscriptions` call, and that * the system should return the next page of data. */ pageToken?: string; /** * The name of the cloud project that subscriptions belong to. */ project?: string; } interface Params$Resource$Projects$Subscriptions$Modifyackdeadline extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The name of the subscription. */ subscription?: string; /** * Request body metadata */ requestBody?: Schema$ModifyAckDeadlineRequest; } interface Params$Resource$Projects$Subscriptions$Modifypushconfig extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The name of the subscription. */ subscription?: string; /** * Request body metadata */ requestBody?: Schema$ModifyPushConfigRequest; } interface Params$Resource$Projects$Subscriptions$Pull extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The subscription from which messages should be pulled. */ subscription?: string; /** * Request body metadata */ requestBody?: Schema$PullRequest; } interface Params$Resource$Projects$Subscriptions$Setiampolicy extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * REQUIRED: The resource for which the policy is being specified. See the * operation documentation for the appropriate value for this field. */ resource?: string; /** * Request body metadata */ requestBody?: Schema$SetIamPolicyRequest; } interface Params$Resource$Projects$Subscriptions$Testiampermissions extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * REQUIRED: The resource for which the policy detail is being requested. * See the operation documentation for the appropriate value for this field. */ resource?: string; /** * Request body metadata */ requestBody?: Schema$TestIamPermissionsRequest; } class Resource$Projects$Topics { subscriptions: Resource$Projects$Topics$Subscriptions; constructor(); /** * pubsub.projects.topics.create * @desc Creates the given topic with the given name. * @alias pubsub.projects.topics.create * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.name The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`. * @param {().Topic} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ create(params?: Params$Resource$Projects$Topics$Create, options?: MethodOptions): GaxiosPromise; create(params: Params$Resource$Projects$Topics$Create, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; create(params: Params$Resource$Projects$Topics$Create, callback: BodyResponseCallback): void; create(callback: BodyResponseCallback): void; /** * pubsub.projects.topics.delete * @desc Deletes the topic with the given name. Returns `NOT_FOUND` if the * topic does not exist. After a topic is deleted, a new topic may be * created with the same name; this is an entirely new topic with none of * the old configuration or subscriptions. Existing subscriptions to this * topic are not deleted, but their `topic` field is set to * `_deleted-topic_`. * @alias pubsub.projects.topics.delete * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.topic Name of the topic to delete. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ delete(params?: Params$Resource$Projects$Topics$Delete, options?: MethodOptions): GaxiosPromise; delete(params: Params$Resource$Projects$Topics$Delete, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; delete(params: Params$Resource$Projects$Topics$Delete, callback: BodyResponseCallback): void; delete(callback: BodyResponseCallback): void; /** * pubsub.projects.topics.get * @desc Gets the configuration of a topic. * @alias pubsub.projects.topics.get * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.topic The name of the topic to get. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ get(params?: Params$Resource$Projects$Topics$Get, options?: MethodOptions): GaxiosPromise; get(params: Params$Resource$Projects$Topics$Get, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; get(params: Params$Resource$Projects$Topics$Get, callback: BodyResponseCallback): void; get(callback: BodyResponseCallback): void; /** * pubsub.projects.topics.getIamPolicy * @desc Gets the access control policy for a resource. Returns an empty * policy if the resource exists and does not have a policy set. * @alias pubsub.projects.topics.getIamPolicy * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.resource_ REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ getIamPolicy(params?: Params$Resource$Projects$Topics$Getiampolicy, options?: MethodOptions): GaxiosPromise; getIamPolicy(params: Params$Resource$Projects$Topics$Getiampolicy, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; getIamPolicy(params: Params$Resource$Projects$Topics$Getiampolicy, callback: BodyResponseCallback): void; getIamPolicy(callback: BodyResponseCallback): void; /** * pubsub.projects.topics.list * @desc Lists matching topics. * @alias pubsub.projects.topics.list * @memberOf! () * * @param {object} params Parameters for request * @param {integer=} params.pageSize Maximum number of topics to return. * @param {string=} params.pageToken The value returned by the last `ListTopicsResponse`; indicates that this is a continuation of a prior `ListTopics` call, and that the system should return the next page of data. * @param {string} params.project The name of the cloud project that topics belong to. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ list(params?: Params$Resource$Projects$Topics$List, options?: MethodOptions): GaxiosPromise; list(params: Params$Resource$Projects$Topics$List, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; list(params: Params$Resource$Projects$Topics$List, callback: BodyResponseCallback): void; list(callback: BodyResponseCallback): void; /** * pubsub.projects.topics.publish * @desc Adds one or more messages to the topic. Returns `NOT_FOUND` if the * topic does not exist. The message payload must not be empty; it must * contain either a non-empty data field, or at least one attribute. * @alias pubsub.projects.topics.publish * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.topic The messages in the request will be published on this topic. * @param {().PublishRequest} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ publish(params?: Params$Resource$Projects$Topics$Publish, options?: MethodOptions): GaxiosPromise; publish(params: Params$Resource$Projects$Topics$Publish, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; publish(params: Params$Resource$Projects$Topics$Publish, callback: BodyResponseCallback): void; publish(callback: BodyResponseCallback): void; /** * pubsub.projects.topics.setIamPolicy * @desc Sets the access control policy on the specified resource. Replaces * any existing policy. * @alias pubsub.projects.topics.setIamPolicy * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.resource_ REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. * @param {().SetIamPolicyRequest} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ setIamPolicy(params?: Params$Resource$Projects$Topics$Setiampolicy, options?: MethodOptions): GaxiosPromise; setIamPolicy(params: Params$Resource$Projects$Topics$Setiampolicy, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; setIamPolicy(params: Params$Resource$Projects$Topics$Setiampolicy, callback: BodyResponseCallback): void; setIamPolicy(callback: BodyResponseCallback): void; /** * pubsub.projects.topics.testIamPermissions * @desc Returns permissions that a caller has on the specified resource. If * the resource does not exist, this will return an empty set of * permissions, not a NOT_FOUND error. Note: This operation is designed to * be used for building permission-aware UIs and command-line tools, not for * authorization checking. This operation may "fail open" without warning. * @alias pubsub.projects.topics.testIamPermissions * @memberOf! () * * @param {object} params Parameters for request * @param {string} params.resource_ REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. * @param {().TestIamPermissionsRequest} params.resource Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ testIamPermissions(params?: Params$Resource$Projects$Topics$Testiampermissions, options?: MethodOptions): GaxiosPromise; testIamPermissions(params: Params$Resource$Projects$Topics$Testiampermissions, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; testIamPermissions(params: Params$Resource$Projects$Topics$Testiampermissions, callback: BodyResponseCallback): void; testIamPermissions(callback: BodyResponseCallback): void; } interface Params$Resource$Projects$Topics$Create extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The name of the topic. It must have the format * `"projects/{project}/topics/{topic}"`. `{topic}` must start with a * letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes * (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or * percent signs (`%`). It must be between 3 and 255 characters in length, * and it must not start with `"goog"`. */ name?: string; /** * Request body metadata */ requestBody?: Schema$Topic; } interface Params$Resource$Projects$Topics$Delete extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * Name of the topic to delete. */ topic?: string; } interface Params$Resource$Projects$Topics$Get extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The name of the topic to get. */ topic?: string; } interface Params$Resource$Projects$Topics$Getiampolicy extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * REQUIRED: The resource for which the policy is being requested. See the * operation documentation for the appropriate value for this field. */ resource?: string; } interface Params$Resource$Projects$Topics$List extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * Maximum number of topics to return. */ pageSize?: number; /** * The value returned by the last `ListTopicsResponse`; indicates that this * is a continuation of a prior `ListTopics` call, and that the system * should return the next page of data. */ pageToken?: string; /** * The name of the cloud project that topics belong to. */ project?: string; } interface Params$Resource$Projects$Topics$Publish extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * The messages in the request will be published on this topic. */ topic?: string; /** * Request body metadata */ requestBody?: Schema$PublishRequest; } interface Params$Resource$Projects$Topics$Setiampolicy extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * REQUIRED: The resource for which the policy is being specified. See the * operation documentation for the appropriate value for this field. */ resource?: string; /** * Request body metadata */ requestBody?: Schema$SetIamPolicyRequest; } interface Params$Resource$Projects$Topics$Testiampermissions extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * REQUIRED: The resource for which the policy detail is being requested. * See the operation documentation for the appropriate value for this field. */ resource?: string; /** * Request body metadata */ requestBody?: Schema$TestIamPermissionsRequest; } class Resource$Projects$Topics$Subscriptions { constructor(); /** * pubsub.projects.topics.subscriptions.list * @desc Lists the name of the subscriptions for this topic. * @alias pubsub.projects.topics.subscriptions.list * @memberOf! () * * @param {object} params Parameters for request * @param {integer=} params.pageSize Maximum number of subscription names to return. * @param {string=} params.pageToken The value returned by the last `ListTopicSubscriptionsResponse`; indicates that this is a continuation of a prior `ListTopicSubscriptions` call, and that the system should return the next page of data. * @param {string} params.topic The name of the topic that subscriptions are attached to. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. * @return {object} Request object */ list(params?: Params$Resource$Projects$Topics$Subscriptions$List, options?: MethodOptions): GaxiosPromise; list(params: Params$Resource$Projects$Topics$Subscriptions$List, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback): void; list(params: Params$Resource$Projects$Topics$Subscriptions$List, callback: BodyResponseCallback): void; list(callback: BodyResponseCallback): void; } interface Params$Resource$Projects$Topics$Subscriptions$List extends StandardParameters { /** * Auth client or API Key for the request */ auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient; /** * Maximum number of subscription names to return. */ pageSize?: number; /** * The value returned by the last `ListTopicSubscriptionsResponse`; * indicates that this is a continuation of a prior `ListTopicSubscriptions` * call, and that the system should return the next page of data. */ pageToken?: string; /** * The name of the topic that subscriptions are attached to. */ topic?: string; } }