File

src/apis/mybusinessplaceactions/v1.ts

Description

My Business Place Actions API

The My Business Place Actions API provides an interface for managing place action links of a location on Google.

const {google} = require('googleapis');
const mybusinessplaceactions = google.mybusinessplaceactions('v1');

Index

Properties

Constructor

constructor(options: GlobalOptions, google?: GoogleConfigurable)
Parameters :
Name Type Optional
options GlobalOptions No
google GoogleConfigurable Yes

Properties

context
Type : APIRequestContext
locations
Type : Resource$Locations
placeActionTypeMetadata
Type : Resource$Placeactiontypemetadata
import {
  OAuth2Client,
  JWT,
  Compute,
  UserRefreshClient,
  BaseExternalAccountClient,
  GaxiosPromise,
  GoogleConfigurable,
  createAPIRequest,
  MethodOptions,
  StreamMethodOptions,
  GlobalOptions,
  GoogleAuth,
  BodyResponseCallback,
  APIRequestContext,
} from 'googleapis-common';
import {Readable} from 'stream';

export namespace mybusinessplaceactions_v1 {
  export interface Options extends GlobalOptions {
    version: 'v1';
  }

  interface StandardParameters {
    /**
     * Auth client or API Key for the request
     */
    auth?:
      | string
      | OAuth2Client
      | JWT
      | Compute
      | UserRefreshClient
      | BaseExternalAccountClient
      | GoogleAuth;

    /**
     * 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;
  }

  /**
   * My Business Place Actions API
   *
   * The My Business Place Actions API provides an interface for managing place action links of a location on Google.
   *
   * @example
   * ```js
   * const {google} = require('googleapis');
   * const mybusinessplaceactions = google.mybusinessplaceactions('v1');
   * ```
   */
  export class Mybusinessplaceactions {
    context: APIRequestContext;
    locations: Resource$Locations;
    placeActionTypeMetadata: Resource$Placeactiontypemetadata;

    constructor(options: GlobalOptions, google?: GoogleConfigurable) {
      this.context = {
        _options: options || {},
        google,
      };

      this.locations = new Resource$Locations(this.context);
      this.placeActionTypeMetadata = new Resource$Placeactiontypemetadata(
        this.context
      );
    }
  }

  /**
   * 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 `{\}`.
   */
  export interface Schema$Empty {}
  /**
   * Response message for PlaceActions.ListPlaceActionLinks.
   */
  export interface Schema$ListPlaceActionLinksResponse {
    /**
     * If there are more place action links than the requested page size, then this field is populated with a token to fetch the next page of results.
     */
    nextPageToken?: string | null;
    /**
     * The returned list of place action links.
     */
    placeActionLinks?: Schema$PlaceActionLink[];
  }
  /**
   * Response message for PlaceActions.ListPlaceActionTypeMetadata.
   */
  export interface Schema$ListPlaceActionTypeMetadataResponse {
    /**
     * If the number of action types exceeded the requested page size, this field will be populated with a token to fetch the next page on a subsequent call to `placeActionTypeMetadata.list`. If there are no more results, this field will not be present in the response.
     */
    nextPageToken?: string | null;
    /**
     * A collection of metadata for the available place action types.
     */
    placeActionTypeMetadata?: Schema$PlaceActionTypeMetadata[];
  }
  /**
   * Represents a place action link and its attributes.
   */
  export interface Schema$PlaceActionLink {
    /**
     * Output only. The time when the place action link was created.
     */
    createTime?: string | null;
    /**
     * Output only. Indicates whether this link can be edited by the client.
     */
    isEditable?: boolean | null;
    /**
     * Optional. Whether this link is preferred by the merchant. Only one link can be marked as preferred per place action type at a location. If a future request marks a different link as preferred for the same place action type, then the current preferred link (if any exists) will lose its preference.
     */
    isPreferred?: boolean | null;
    /**
     * Optional. The resource name, in the format `locations/{location_id\}/placeActionLinks/{place_action_link_id\}`. The name field will only be considered in UpdatePlaceActionLink and DeletePlaceActionLink requests for updating and deleting links respectively. However, it will be ignored in CreatePlaceActionLink request, where `place_action_link_id` will be assigned by the server on successful creation of a new link and returned as part of the response.
     */
    name?: string | null;
    /**
     * Required. The type of place action that can be performed using this link.
     */
    placeActionType?: string | null;
    /**
     * Output only. Specifies the provider type.
     */
    providerType?: string | null;
    /**
     * Output only. The time when the place action link was last modified.
     */
    updateTime?: string | null;
    /**
     * Required. The link uri. The same uri can be reused for different action types across different locations. However, only one place action link is allowed for each unique combination of (uri, place action type, location).
     */
    uri?: string | null;
  }
  /**
   * Metadata for supported place action types.
   */
  export interface Schema$PlaceActionTypeMetadata {
    /**
     * The localized display name for the attribute, if available; otherwise, the English display name.
     */
    displayName?: string | null;
    /**
     * The place action type.
     */
    placeActionType?: string | null;
  }

  export class Resource$Locations {
    context: APIRequestContext;
    placeActionLinks: Resource$Locations$Placeactionlinks;
    constructor(context: APIRequestContext) {
      this.context = context;
      this.placeActionLinks = new Resource$Locations$Placeactionlinks(
        this.context
      );
    }
  }

  export class Resource$Locations$Placeactionlinks {
    context: APIRequestContext;
    constructor(context: APIRequestContext) {
      this.context = context;
    }

    /**
     * Creates a place action link associated with the specified location, and returns it. The request is considered duplicate if the `parent`, `place_action_link.uri` and `place_action_link.place_action_type` are the same as a previous request.
     * @example
     * ```js
     * // Before running the sample:
     * // - Enable the API at:
     * //   https://console.developers.google.com/apis/api/mybusinessplaceactions.googleapis.com
     * // - Login into gcloud by running:
     * //   `$ gcloud auth application-default login`
     * // - Install the npm module by running:
     * //   `$ npm install googleapis`
     *
     * const {google} = require('googleapis');
     * const mybusinessplaceactions = google.mybusinessplaceactions('v1');
     *
     * async function main() {
     *   const auth = new google.auth.GoogleAuth({
     *     // Scopes can be specified either as an array or as a single, space-delimited string.
     *     scopes: [],
     *   });
     *
     *   // Acquire an auth client, and bind it to all future calls
     *   const authClient = await auth.getClient();
     *   google.options({auth: authClient});
     *
     *   // Do the magic
     *   const res = await mybusinessplaceactions.locations.placeActionLinks.create({
     *     // Required. The resource name of the location where to create this place action link. `locations/{location_id\}`.
     *     parent: 'locations/my-location',
     *
     *     // Request body metadata
     *     requestBody: {
     *       // request body parameters
     *       // {
     *       //   "createTime": "my_createTime",
     *       //   "isEditable": false,
     *       //   "isPreferred": false,
     *       //   "name": "my_name",
     *       //   "placeActionType": "my_placeActionType",
     *       //   "providerType": "my_providerType",
     *       //   "updateTime": "my_updateTime",
     *       //   "uri": "my_uri"
     *       // }
     *     },
     *   });
     *   console.log(res.data);
     *
     *   // Example response
     *   // {
     *   //   "createTime": "my_createTime",
     *   //   "isEditable": false,
     *   //   "isPreferred": false,
     *   //   "name": "my_name",
     *   //   "placeActionType": "my_placeActionType",
     *   //   "providerType": "my_providerType",
     *   //   "updateTime": "my_updateTime",
     *   //   "uri": "my_uri"
     *   // }
     * }
     *
     * main().catch(e => {
     *   console.error(e);
     *   throw e;
     * });
     *
     * ```
     *
     * @param params - Parameters for request
     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
     * @param callback - Optional callback that handles the response.
     * @returns A promise if used with async/await, or void if used with a callback.
     */
    create(
      params: Params$Resource$Locations$Placeactionlinks$Create,
      options: StreamMethodOptions
    ): GaxiosPromise<Readable>;
    create(
      params?: Params$Resource$Locations$Placeactionlinks$Create,
      options?: MethodOptions
    ): GaxiosPromise<Schema$PlaceActionLink>;
    create(
      params: Params$Resource$Locations$Placeactionlinks$Create,
      options: StreamMethodOptions | BodyResponseCallback<Readable>,
      callback: BodyResponseCallback<Readable>
    ): void;
    create(
      params: Params$Resource$Locations$Placeactionlinks$Create,
      options: MethodOptions | BodyResponseCallback<Schema$PlaceActionLink>,
      callback: BodyResponseCallback<Schema$PlaceActionLink>
    ): void;
    create(
      params: Params$Resource$Locations$Placeactionlinks$Create,
      callback: BodyResponseCallback<Schema$PlaceActionLink>
    ): void;
    create(callback: BodyResponseCallback<Schema$PlaceActionLink>): void;
    create(
      paramsOrCallback?:
        | Params$Resource$Locations$Placeactionlinks$Create
        | BodyResponseCallback<Schema$PlaceActionLink>
        | BodyResponseCallback<Readable>,
      optionsOrCallback?:
        | MethodOptions
        | StreamMethodOptions
        | BodyResponseCallback<Schema$PlaceActionLink>
        | BodyResponseCallback<Readable>,
      callback?:
        | BodyResponseCallback<Schema$PlaceActionLink>
        | BodyResponseCallback<Readable>
    ): void | GaxiosPromise<Schema$PlaceActionLink> | GaxiosPromise<Readable> {
      let params = (paramsOrCallback ||
        {}) as Params$Resource$Locations$Placeactionlinks$Create;
      let options = (optionsOrCallback || {}) as MethodOptions;

      if (typeof paramsOrCallback === 'function') {
        callback = paramsOrCallback;
        params = {} as Params$Resource$Locations$Placeactionlinks$Create;
        options = {};
      }

      if (typeof optionsOrCallback === 'function') {
        callback = optionsOrCallback;
        options = {};
      }

      const rootUrl =
        options.rootUrl || 'https://mybusinessplaceactions.googleapis.com/';
      const parameters = {
        options: Object.assign(
          {
            url: (rootUrl + '/v1/{+parent}/placeActionLinks').replace(
              /([^:]\/)\/+/g,
              '$1'
            ),
            method: 'POST',
          },
          options
        ),
        params,
        requiredParams: ['parent'],
        pathParams: ['parent'],
        context: this.context,
      };
      if (callback) {
        createAPIRequest<Schema$PlaceActionLink>(
          parameters,
          callback as BodyResponseCallback<unknown>
        );
      } else {
        return createAPIRequest<Schema$PlaceActionLink>(parameters);
      }
    }

    /**
     * Deletes a place action link from the specified location.
     * @example
     * ```js
     * // Before running the sample:
     * // - Enable the API at:
     * //   https://console.developers.google.com/apis/api/mybusinessplaceactions.googleapis.com
     * // - Login into gcloud by running:
     * //   `$ gcloud auth application-default login`
     * // - Install the npm module by running:
     * //   `$ npm install googleapis`
     *
     * const {google} = require('googleapis');
     * const mybusinessplaceactions = google.mybusinessplaceactions('v1');
     *
     * async function main() {
     *   const auth = new google.auth.GoogleAuth({
     *     // Scopes can be specified either as an array or as a single, space-delimited string.
     *     scopes: [],
     *   });
     *
     *   // Acquire an auth client, and bind it to all future calls
     *   const authClient = await auth.getClient();
     *   google.options({auth: authClient});
     *
     *   // Do the magic
     *   const res = await mybusinessplaceactions.locations.placeActionLinks.delete({
     *     // Required. The resource name of the place action link to remove from the location.
     *     name: 'locations/my-location/placeActionLinks/my-placeActionLink',
     *   });
     *   console.log(res.data);
     *
     *   // Example response
     *   // {}
     * }
     *
     * main().catch(e => {
     *   console.error(e);
     *   throw e;
     * });
     *
     * ```
     *
     * @param params - Parameters for request
     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
     * @param callback - Optional callback that handles the response.
     * @returns A promise if used with async/await, or void if used with a callback.
     */
    delete(
      params: Params$Resource$Locations$Placeactionlinks$Delete,
      options: StreamMethodOptions
    ): GaxiosPromise<Readable>;
    delete(
      params?: Params$Resource$Locations$Placeactionlinks$Delete,
      options?: MethodOptions
    ): GaxiosPromise<Schema$Empty>;
    delete(
      params: Params$Resource$Locations$Placeactionlinks$Delete,
      options: StreamMethodOptions | BodyResponseCallback<Readable>,
      callback: BodyResponseCallback<Readable>
    ): void;
    delete(
      params: Params$Resource$Locations$Placeactionlinks$Delete,
      options: MethodOptions | BodyResponseCallback<Schema$Empty>,
      callback: BodyResponseCallback<Schema$Empty>
    ): void;
    delete(
      params: Params$Resource$Locations$Placeactionlinks$Delete,
      callback: BodyResponseCallback<Schema$Empty>
    ): void;
    delete(callback: BodyResponseCallback<Schema$Empty>): void;
    delete(
      paramsOrCallback?:
        | Params$Resource$Locations$Placeactionlinks$Delete
        | BodyResponseCallback<Schema$Empty>
        | BodyResponseCallback<Readable>,
      optionsOrCallback?:
        | MethodOptions
        | StreamMethodOptions
        | BodyResponseCallback<Schema$Empty>
        | BodyResponseCallback<Readable>,
      callback?:
        | BodyResponseCallback<Schema$Empty>
        | BodyResponseCallback<Readable>
    ): void | GaxiosPromise<Schema$Empty> | GaxiosPromise<Readable> {
      let params = (paramsOrCallback ||
        {}) as Params$Resource$Locations$Placeactionlinks$Delete;
      let options = (optionsOrCallback || {}) as MethodOptions;

      if (typeof paramsOrCallback === 'function') {
        callback = paramsOrCallback;
        params = {} as Params$Resource$Locations$Placeactionlinks$Delete;
        options = {};
      }

      if (typeof optionsOrCallback === 'function') {
        callback = optionsOrCallback;
        options = {};
      }

      const rootUrl =
        options.rootUrl || 'https://mybusinessplaceactions.googleapis.com/';
      const parameters = {
        options: Object.assign(
          {
            url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'),
            method: 'DELETE',
          },
          options
        ),
        params,
        requiredParams: ['name'],
        pathParams: ['name'],
        context: this.context,
      };
      if (callback) {
        createAPIRequest<Schema$Empty>(
          parameters,
          callback as BodyResponseCallback<unknown>
        );
      } else {
        return createAPIRequest<Schema$Empty>(parameters);
      }
    }

    /**
     * Gets the specified place action link.
     * @example
     * ```js
     * // Before running the sample:
     * // - Enable the API at:
     * //   https://console.developers.google.com/apis/api/mybusinessplaceactions.googleapis.com
     * // - Login into gcloud by running:
     * //   `$ gcloud auth application-default login`
     * // - Install the npm module by running:
     * //   `$ npm install googleapis`
     *
     * const {google} = require('googleapis');
     * const mybusinessplaceactions = google.mybusinessplaceactions('v1');
     *
     * async function main() {
     *   const auth = new google.auth.GoogleAuth({
     *     // Scopes can be specified either as an array or as a single, space-delimited string.
     *     scopes: [],
     *   });
     *
     *   // Acquire an auth client, and bind it to all future calls
     *   const authClient = await auth.getClient();
     *   google.options({auth: authClient});
     *
     *   // Do the magic
     *   const res = await mybusinessplaceactions.locations.placeActionLinks.get({
     *     // Required. The name of the place action link to fetch.
     *     name: 'locations/my-location/placeActionLinks/my-placeActionLink',
     *   });
     *   console.log(res.data);
     *
     *   // Example response
     *   // {
     *   //   "createTime": "my_createTime",
     *   //   "isEditable": false,
     *   //   "isPreferred": false,
     *   //   "name": "my_name",
     *   //   "placeActionType": "my_placeActionType",
     *   //   "providerType": "my_providerType",
     *   //   "updateTime": "my_updateTime",
     *   //   "uri": "my_uri"
     *   // }
     * }
     *
     * main().catch(e => {
     *   console.error(e);
     *   throw e;
     * });
     *
     * ```
     *
     * @param params - Parameters for request
     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
     * @param callback - Optional callback that handles the response.
     * @returns A promise if used with async/await, or void if used with a callback.
     */
    get(
      params: Params$Resource$Locations$Placeactionlinks$Get,
      options: StreamMethodOptions
    ): GaxiosPromise<Readable>;
    get(
      params?: Params$Resource$Locations$Placeactionlinks$Get,
      options?: MethodOptions
    ): GaxiosPromise<Schema$PlaceActionLink>;
    get(
      params: Params$Resource$Locations$Placeactionlinks$Get,
      options: StreamMethodOptions | BodyResponseCallback<Readable>,
      callback: BodyResponseCallback<Readable>
    ): void;
    get(
      params: Params$Resource$Locations$Placeactionlinks$Get,
      options: MethodOptions | BodyResponseCallback<Schema$PlaceActionLink>,
      callback: BodyResponseCallback<Schema$PlaceActionLink>
    ): void;
    get(
      params: Params$Resource$Locations$Placeactionlinks$Get,
      callback: BodyResponseCallback<Schema$PlaceActionLink>
    ): void;
    get(callback: BodyResponseCallback<Schema$PlaceActionLink>): void;
    get(
      paramsOrCallback?:
        | Params$Resource$Locations$Placeactionlinks$Get
        | BodyResponseCallback<Schema$PlaceActionLink>
        | BodyResponseCallback<Readable>,
      optionsOrCallback?:
        | MethodOptions
        | StreamMethodOptions
        | BodyResponseCallback<Schema$PlaceActionLink>
        | BodyResponseCallback<Readable>,
      callback?:
        | BodyResponseCallback<Schema$PlaceActionLink>
        | BodyResponseCallback<Readable>
    ): void | GaxiosPromise<Schema$PlaceActionLink> | GaxiosPromise<Readable> {
      let params = (paramsOrCallback ||
        {}) as Params$Resource$Locations$Placeactionlinks$Get;
      let options = (optionsOrCallback || {}) as MethodOptions;

      if (typeof paramsOrCallback === 'function') {
        callback = paramsOrCallback;
        params = {} as Params$Resource$Locations$Placeactionlinks$Get;
        options = {};
      }

      if (typeof optionsOrCallback === 'function') {
        callback = optionsOrCallback;
        options = {};
      }

      const rootUrl =
        options.rootUrl || 'https://mybusinessplaceactions.googleapis.com/';
      const parameters = {
        options: Object.assign(
          {
            url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'),
            method: 'GET',
          },
          options
        ),
        params,
        requiredParams: ['name'],
        pathParams: ['name'],
        context: this.context,
      };
      if (callback) {
        createAPIRequest<Schema$PlaceActionLink>(
          parameters,
          callback as BodyResponseCallback<unknown>
        );
      } else {
        return createAPIRequest<Schema$PlaceActionLink>(parameters);
      }
    }

    /**
     * Lists the place action links for the specified location.
     * @example
     * ```js
     * // Before running the sample:
     * // - Enable the API at:
     * //   https://console.developers.google.com/apis/api/mybusinessplaceactions.googleapis.com
     * // - Login into gcloud by running:
     * //   `$ gcloud auth application-default login`
     * // - Install the npm module by running:
     * //   `$ npm install googleapis`
     *
     * const {google} = require('googleapis');
     * const mybusinessplaceactions = google.mybusinessplaceactions('v1');
     *
     * async function main() {
     *   const auth = new google.auth.GoogleAuth({
     *     // Scopes can be specified either as an array or as a single, space-delimited string.
     *     scopes: [],
     *   });
     *
     *   // Acquire an auth client, and bind it to all future calls
     *   const authClient = await auth.getClient();
     *   google.options({auth: authClient});
     *
     *   // Do the magic
     *   const res = await mybusinessplaceactions.locations.placeActionLinks.list({
     *     // Optional. A filter constraining the place action links to return. The response includes entries that match the filter. We support only the following filter: 1. place_action_type=XYZ where XYZ is a valid PlaceActionType.
     *     filter: 'placeholder-value',
     *     // Optional. How many place action links to return per page. Default of 10. The minimum is 1.
     *     pageSize: 'placeholder-value',
     *     // Optional. If specified, returns the next page of place action links.
     *     pageToken: 'placeholder-value',
     *     // Required. The name of the location whose place action links will be listed. `locations/{location_id\}`.
     *     parent: 'locations/my-location',
     *   });
     *   console.log(res.data);
     *
     *   // Example response
     *   // {
     *   //   "nextPageToken": "my_nextPageToken",
     *   //   "placeActionLinks": []
     *   // }
     * }
     *
     * main().catch(e => {
     *   console.error(e);
     *   throw e;
     * });
     *
     * ```
     *
     * @param params - Parameters for request
     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
     * @param callback - Optional callback that handles the response.
     * @returns A promise if used with async/await, or void if used with a callback.
     */
    list(
      params: Params$Resource$Locations$Placeactionlinks$List,
      options: StreamMethodOptions
    ): GaxiosPromise<Readable>;
    list(
      params?: Params$Resource$Locations$Placeactionlinks$List,
      options?: MethodOptions
    ): GaxiosPromise<Schema$ListPlaceActionLinksResponse>;
    list(
      params: Params$Resource$Locations$Placeactionlinks$List,
      options: StreamMethodOptions | BodyResponseCallback<Readable>,
      callback: BodyResponseCallback<Readable>
    ): void;
    list(
      params: Params$Resource$Locations$Placeactionlinks$List,
      options:
        | MethodOptions
        | BodyResponseCallback<Schema$ListPlaceActionLinksResponse>,
      callback: BodyResponseCallback<Schema$ListPlaceActionLinksResponse>
    ): void;
    list(
      params: Params$Resource$Locations$Placeactionlinks$List,
      callback: BodyResponseCallback<Schema$ListPlaceActionLinksResponse>
    ): void;
    list(
      callback: BodyResponseCallback<Schema$ListPlaceActionLinksResponse>
    ): void;
    list(
      paramsOrCallback?:
        | Params$Resource$Locations$Placeactionlinks$List
        | BodyResponseCallback<Schema$ListPlaceActionLinksResponse>
        | BodyResponseCallback<Readable>,
      optionsOrCallback?:
        | MethodOptions
        | StreamMethodOptions
        | BodyResponseCallback<Schema$ListPlaceActionLinksResponse>
        | BodyResponseCallback<Readable>,
      callback?:
        | BodyResponseCallback<Schema$ListPlaceActionLinksResponse>
        | BodyResponseCallback<Readable>
    ):
      | void
      | GaxiosPromise<Schema$ListPlaceActionLinksResponse>
      | GaxiosPromise<Readable> {
      let params = (paramsOrCallback ||
        {}) as Params$Resource$Locations$Placeactionlinks$List;
      let options = (optionsOrCallback || {}) as MethodOptions;

      if (typeof paramsOrCallback === 'function') {
        callback = paramsOrCallback;
        params = {} as Params$Resource$Locations$Placeactionlinks$List;
        options = {};
      }

      if (typeof optionsOrCallback === 'function') {
        callback = optionsOrCallback;
        options = {};
      }

      const rootUrl =
        options.rootUrl || 'https://mybusinessplaceactions.googleapis.com/';
      const parameters = {
        options: Object.assign(
          {
            url: (rootUrl + '/v1/{+parent}/placeActionLinks').replace(
              /([^:]\/)\/+/g,
              '$1'
            ),
            method: 'GET',
          },
          options
        ),
        params,
        requiredParams: ['parent'],
        pathParams: ['parent'],
        context: this.context,
      };
      if (callback) {
        createAPIRequest<Schema$ListPlaceActionLinksResponse>(
          parameters,
          callback as BodyResponseCallback<unknown>
        );
      } else {
        return createAPIRequest<Schema$ListPlaceActionLinksResponse>(
          parameters
        );
      }
    }

    /**
     * Updates the specified place action link and returns it.
     * @example
     * ```js
     * // Before running the sample:
     * // - Enable the API at:
     * //   https://console.developers.google.com/apis/api/mybusinessplaceactions.googleapis.com
     * // - Login into gcloud by running:
     * //   `$ gcloud auth application-default login`
     * // - Install the npm module by running:
     * //   `$ npm install googleapis`
     *
     * const {google} = require('googleapis');
     * const mybusinessplaceactions = google.mybusinessplaceactions('v1');
     *
     * async function main() {
     *   const auth = new google.auth.GoogleAuth({
     *     // Scopes can be specified either as an array or as a single, space-delimited string.
     *     scopes: [],
     *   });
     *
     *   // Acquire an auth client, and bind it to all future calls
     *   const authClient = await auth.getClient();
     *   google.options({auth: authClient});
     *
     *   // Do the magic
     *   const res = await mybusinessplaceactions.locations.placeActionLinks.patch({
     *     // Optional. The resource name, in the format `locations/{location_id\}/placeActionLinks/{place_action_link_id\}`. The name field will only be considered in UpdatePlaceActionLink and DeletePlaceActionLink requests for updating and deleting links respectively. However, it will be ignored in CreatePlaceActionLink request, where `place_action_link_id` will be assigned by the server on successful creation of a new link and returned as part of the response.
     *     name: 'locations/my-location/placeActionLinks/my-placeActionLink',
     *     // Required. The specific fields to update. The only editable fields are `uri`, `place_action_type` and `is_preferred`. If the updated link already exists at the same location with the same `place_action_type` and `uri`, fails with an `ALREADY_EXISTS` error.
     *     updateMask: 'placeholder-value',
     *
     *     // Request body metadata
     *     requestBody: {
     *       // request body parameters
     *       // {
     *       //   "createTime": "my_createTime",
     *       //   "isEditable": false,
     *       //   "isPreferred": false,
     *       //   "name": "my_name",
     *       //   "placeActionType": "my_placeActionType",
     *       //   "providerType": "my_providerType",
     *       //   "updateTime": "my_updateTime",
     *       //   "uri": "my_uri"
     *       // }
     *     },
     *   });
     *   console.log(res.data);
     *
     *   // Example response
     *   // {
     *   //   "createTime": "my_createTime",
     *   //   "isEditable": false,
     *   //   "isPreferred": false,
     *   //   "name": "my_name",
     *   //   "placeActionType": "my_placeActionType",
     *   //   "providerType": "my_providerType",
     *   //   "updateTime": "my_updateTime",
     *   //   "uri": "my_uri"
     *   // }
     * }
     *
     * main().catch(e => {
     *   console.error(e);
     *   throw e;
     * });
     *
     * ```
     *
     * @param params - Parameters for request
     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
     * @param callback - Optional callback that handles the response.
     * @returns A promise if used with async/await, or void if used with a callback.
     */
    patch(
      params: Params$Resource$Locations$Placeactionlinks$Patch,
      options: StreamMethodOptions
    ): GaxiosPromise<Readable>;
    patch(
      params?: Params$Resource$Locations$Placeactionlinks$Patch,
      options?: MethodOptions
    ): GaxiosPromise<Schema$PlaceActionLink>;
    patch(
      params: Params$Resource$Locations$Placeactionlinks$Patch,
      options: StreamMethodOptions | BodyResponseCallback<Readable>,
      callback: BodyResponseCallback<Readable>
    ): void;
    patch(
      params: Params$Resource$Locations$Placeactionlinks$Patch,
      options: MethodOptions | BodyResponseCallback<Schema$PlaceActionLink>,
      callback: BodyResponseCallback<Schema$PlaceActionLink>
    ): void;
    patch(
      params: Params$Resource$Locations$Placeactionlinks$Patch,
      callback: BodyResponseCallback<Schema$PlaceActionLink>
    ): void;
    patch(callback: BodyResponseCallback<Schema$PlaceActionLink>): void;
    patch(
      paramsOrCallback?:
        | Params$Resource$Locations$Placeactionlinks$Patch
        | BodyResponseCallback<Schema$PlaceActionLink>
        | BodyResponseCallback<Readable>,
      optionsOrCallback?:
        | MethodOptions
        | StreamMethodOptions
        | BodyResponseCallback<Schema$PlaceActionLink>
        | BodyResponseCallback<Readable>,
      callback?:
        | BodyResponseCallback<Schema$PlaceActionLink>
        | BodyResponseCallback<Readable>
    ): void | GaxiosPromise<Schema$PlaceActionLink> | GaxiosPromise<Readable> {
      let params = (paramsOrCallback ||
        {}) as Params$Resource$Locations$Placeactionlinks$Patch;
      let options = (optionsOrCallback || {}) as MethodOptions;

      if (typeof paramsOrCallback === 'function') {
        callback = paramsOrCallback;
        params = {} as Params$Resource$Locations$Placeactionlinks$Patch;
        options = {};
      }

      if (typeof optionsOrCallback === 'function') {
        callback = optionsOrCallback;
        options = {};
      }

      const rootUrl =
        options.rootUrl || 'https://mybusinessplaceactions.googleapis.com/';
      const parameters = {
        options: Object.assign(
          {
            url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'),
            method: 'PATCH',
          },
          options
        ),
        params,
        requiredParams: ['name'],
        pathParams: ['name'],
        context: this.context,
      };
      if (callback) {
        createAPIRequest<Schema$PlaceActionLink>(
          parameters,
          callback as BodyResponseCallback<unknown>
        );
      } else {
        return createAPIRequest<Schema$PlaceActionLink>(parameters);
      }
    }
  }

  export interface Params$Resource$Locations$Placeactionlinks$Create
    extends StandardParameters {
    /**
     * Required. The resource name of the location where to create this place action link. `locations/{location_id\}`.
     */
    parent?: string;

    /**
     * Request body metadata
     */
    requestBody?: Schema$PlaceActionLink;
  }
  export interface Params$Resource$Locations$Placeactionlinks$Delete
    extends StandardParameters {
    /**
     * Required. The resource name of the place action link to remove from the location.
     */
    name?: string;
  }
  export interface Params$Resource$Locations$Placeactionlinks$Get
    extends StandardParameters {
    /**
     * Required. The name of the place action link to fetch.
     */
    name?: string;
  }
  export interface Params$Resource$Locations$Placeactionlinks$List
    extends StandardParameters {
    /**
     * Optional. A filter constraining the place action links to return. The response includes entries that match the filter. We support only the following filter: 1. place_action_type=XYZ where XYZ is a valid PlaceActionType.
     */
    filter?: string;
    /**
     * Optional. How many place action links to return per page. Default of 10. The minimum is 1.
     */
    pageSize?: number;
    /**
     * Optional. If specified, returns the next page of place action links.
     */
    pageToken?: string;
    /**
     * Required. The name of the location whose place action links will be listed. `locations/{location_id\}`.
     */
    parent?: string;
  }
  export interface Params$Resource$Locations$Placeactionlinks$Patch
    extends StandardParameters {
    /**
     * Optional. The resource name, in the format `locations/{location_id\}/placeActionLinks/{place_action_link_id\}`. The name field will only be considered in UpdatePlaceActionLink and DeletePlaceActionLink requests for updating and deleting links respectively. However, it will be ignored in CreatePlaceActionLink request, where `place_action_link_id` will be assigned by the server on successful creation of a new link and returned as part of the response.
     */
    name?: string;
    /**
     * Required. The specific fields to update. The only editable fields are `uri`, `place_action_type` and `is_preferred`. If the updated link already exists at the same location with the same `place_action_type` and `uri`, fails with an `ALREADY_EXISTS` error.
     */
    updateMask?: string;

    /**
     * Request body metadata
     */
    requestBody?: Schema$PlaceActionLink;
  }

  export class Resource$Placeactiontypemetadata {
    context: APIRequestContext;
    constructor(context: APIRequestContext) {
      this.context = context;
    }

    /**
     * Returns the list of available place action types for a location or country.
     * @example
     * ```js
     * // Before running the sample:
     * // - Enable the API at:
     * //   https://console.developers.google.com/apis/api/mybusinessplaceactions.googleapis.com
     * // - Login into gcloud by running:
     * //   `$ gcloud auth application-default login`
     * // - Install the npm module by running:
     * //   `$ npm install googleapis`
     *
     * const {google} = require('googleapis');
     * const mybusinessplaceactions = google.mybusinessplaceactions('v1');
     *
     * async function main() {
     *   const auth = new google.auth.GoogleAuth({
     *     // Scopes can be specified either as an array or as a single, space-delimited string.
     *     scopes: [],
     *   });
     *
     *   // Acquire an auth client, and bind it to all future calls
     *   const authClient = await auth.getClient();
     *   google.options({auth: authClient});
     *
     *   // Do the magic
     *   const res = await mybusinessplaceactions.placeActionTypeMetadata.list({
     *     // Optional. A filter constraining the place action types to return metadata for. The response includes entries that match the filter. We support only the following filters: 1. location=XYZ where XYZ is a string indicating the resource name of a location, in the format `locations/{location_id\}`. 2. region_code=XYZ where XYZ is a Unicode CLDR region code to find available action types. If no filter is provided, all place action types are returned.
     *     filter: 'placeholder-value',
     *     // Optional. The IETF BCP-47 code of language to get display names in. If this language is not available, they will be provided in English.
     *     languageCode: 'placeholder-value',
     *     // Optional. How many action types to include per page. Default is 10, minimum is 1.
     *     pageSize: 'placeholder-value',
     *     // Optional. If specified, the next page of place action type metadata is retrieved. The `pageToken` is returned when a call to `placeActionTypeMetadata.list` returns more results than can fit into the requested page size.
     *     pageToken: 'placeholder-value',
     *   });
     *   console.log(res.data);
     *
     *   // Example response
     *   // {
     *   //   "nextPageToken": "my_nextPageToken",
     *   //   "placeActionTypeMetadata": []
     *   // }
     * }
     *
     * main().catch(e => {
     *   console.error(e);
     *   throw e;
     * });
     *
     * ```
     *
     * @param params - Parameters for request
     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
     * @param callback - Optional callback that handles the response.
     * @returns A promise if used with async/await, or void if used with a callback.
     */
    list(
      params: Params$Resource$Placeactiontypemetadata$List,
      options: StreamMethodOptions
    ): GaxiosPromise<Readable>;
    list(
      params?: Params$Resource$Placeactiontypemetadata$List,
      options?: MethodOptions
    ): GaxiosPromise<Schema$ListPlaceActionTypeMetadataResponse>;
    list(
      params: Params$Resource$Placeactiontypemetadata$List,
      options: StreamMethodOptions | BodyResponseCallback<Readable>,
      callback: BodyResponseCallback<Readable>
    ): void;
    list(
      params: Params$Resource$Placeactiontypemetadata$List,
      options:
        | MethodOptions
        | BodyResponseCallback<Schema$ListPlaceActionTypeMetadataResponse>,
      callback: BodyResponseCallback<Schema$ListPlaceActionTypeMetadataResponse>
    ): void;
    list(
      params: Params$Resource$Placeactiontypemetadata$List,
      callback: BodyResponseCallback<Schema$ListPlaceActionTypeMetadataResponse>
    ): void;
    list(
      callback: BodyResponseCallback<Schema$ListPlaceActionTypeMetadataResponse>
    ): void;
    list(
      paramsOrCallback?:
        | Params$Resource$Placeactiontypemetadata$List
        | BodyResponseCallback<Schema$ListPlaceActionTypeMetadataResponse>
        | BodyResponseCallback<Readable>,
      optionsOrCallback?:
        | MethodOptions
        | StreamMethodOptions
        | BodyResponseCallback<Schema$ListPlaceActionTypeMetadataResponse>
        | BodyResponseCallback<Readable>,
      callback?:
        | BodyResponseCallback<Schema$ListPlaceActionTypeMetadataResponse>
        | BodyResponseCallback<Readable>
    ):
      | void
      | GaxiosPromise<Schema$ListPlaceActionTypeMetadataResponse>
      | GaxiosPromise<Readable> {
      let params = (paramsOrCallback ||
        {}) as Params$Resource$Placeactiontypemetadata$List;
      let options = (optionsOrCallback || {}) as MethodOptions;

      if (typeof paramsOrCallback === 'function') {
        callback = paramsOrCallback;
        params = {} as Params$Resource$Placeactiontypemetadata$List;
        options = {};
      }

      if (typeof optionsOrCallback === 'function') {
        callback = optionsOrCallback;
        options = {};
      }

      const rootUrl =
        options.rootUrl || 'https://mybusinessplaceactions.googleapis.com/';
      const parameters = {
        options: Object.assign(
          {
            url: (rootUrl + '/v1/placeActionTypeMetadata').replace(
              /([^:]\/)\/+/g,
              '$1'
            ),
            method: 'GET',
          },
          options
        ),
        params,
        requiredParams: [],
        pathParams: [],
        context: this.context,
      };
      if (callback) {
        createAPIRequest<Schema$ListPlaceActionTypeMetadataResponse>(
          parameters,
          callback as BodyResponseCallback<unknown>
        );
      } else {
        return createAPIRequest<Schema$ListPlaceActionTypeMetadataResponse>(
          parameters
        );
      }
    }
  }

  export interface Params$Resource$Placeactiontypemetadata$List
    extends StandardParameters {
    /**
     * Optional. A filter constraining the place action types to return metadata for. The response includes entries that match the filter. We support only the following filters: 1. location=XYZ where XYZ is a string indicating the resource name of a location, in the format `locations/{location_id\}`. 2. region_code=XYZ where XYZ is a Unicode CLDR region code to find available action types. If no filter is provided, all place action types are returned.
     */
    filter?: string;
    /**
     * Optional. The IETF BCP-47 code of language to get display names in. If this language is not available, they will be provided in English.
     */
    languageCode?: string;
    /**
     * Optional. How many action types to include per page. Default is 10, minimum is 1.
     */
    pageSize?: number;
    /**
     * Optional. If specified, the next page of place action type metadata is retrieved. The `pageToken` is returned when a call to `placeActionTypeMetadata.list` returns more results than can fit into the requested page size.
     */
    pageToken?: string;
  }
}

result-matching ""

    No results matching ""