@googleapis/merchantapi 16.1.0 → 17.1.0

package/build/accounts_v1beta.d.ts

@@ -219,6 +219,10 @@ export declare namespace merchantapi_accounts_v1beta {
          * Service type for managing advertising campaigns. Grants the provider access to create and manage the business's ad campaigns, including setting up campaigns, adjusting bids, and optimizing performance.
          */
         campaignsManagement?: Schema$CampaignsManagement;
+        /**
+         * Service type for comparison shopping. The provider is a CSS (Comparison Shopping Service) managing the account. See https://support.google.com/merchants/answer/12653197
+         */
+        comparisonShopping?: Schema$ComparisonShopping;
         /**
          * Immutable. An optional, immutable identifier that Google uses to refer to this account when communicating with the provider. This should be the unique account ID within the provider's system (for example, your shop ID in Shopify). If you have multiple accounts with the same provider - for instance, different accounts for various regions — the `external_account_id` differentiates between them, ensuring accurate linking and integration between Google and the provider.
          */
@@ -260,6 +264,26 @@ export declare namespace merchantapi_accounts_v1beta {
          * The provider is an [aggregator](https://support.google.com/merchants/answer/188487) for the account. Payload for service type Account Aggregation.
          */
         accountAggregation?: Schema$AccountAggregation;
+        /**
+         * The provider manages this account. Payload for service type Account Management.
+         */
+        accountManagement?: Schema$AccountManagement;
+        /**
+         * The provider manages campaigns for this account. Payload for service type campaigns management.
+         */
+        campaignsManagement?: Schema$CampaignsManagement;
+        /**
+         * The provider is a CSS (Comparison Shopping Service) of this account. Payload for service type Comparison Shopping.
+         */
+        comparisonShopping?: Schema$ComparisonShopping;
+        /**
+         * Immutable. An optional, immutable identifier that Google uses to refer to this account when communicating with the provider. This should be the unique account ID within the provider's system (for example, your shop ID in Shopify). If you have multiple accounts with the same provider - for instance, different accounts for various regions — the `external_account_id` differentiates between them, ensuring accurate linking and integration between Google and the provider. The external account ID must be specified for the campaigns management service type. The external account ID must not be specified for the account aggregation service type. The external account ID is optional / may be specified for all other service types.
+         */
+        externalAccountId?: string | null;
+        /**
+         * The provider manages products for this account. Payload for service type products management.
+         */
+        productsManagement?: Schema$ProductsManagement;
         /**
          * Required. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
          */
@@ -302,6 +326,10 @@ export declare namespace merchantapi_accounts_v1beta {
          * Required. The email address of the user (for example, `john.doe@gmail.com`).
          */
         userId?: string | null;
+        /**
+         * Optional. Settings related to configuring the verification email that is sent after adding a user.
+         */
+        verificationMailSettings?: Schema$VerificationMailSettings;
     }
     /**
      * Request to approve an account service.
@@ -544,6 +572,11 @@ export declare namespace merchantapi_accounts_v1beta {
          */
         overwrite?: boolean | null;
     }
+    /**
+     * `ComparisonShopping` payload.
+     */
+    export interface Schema$ComparisonShopping {
+    }
     /**
      * Request message for the `CreateAndConfigureAccount` method.
      */
@@ -556,6 +589,10 @@ export declare namespace merchantapi_accounts_v1beta {
          * Required. An account service between the account to be created and the provider account is initialized as part of the creation. At least one such service needs to be provided. Currently exactly one of these needs to be `account_aggregation` and `accounts.createAndConfigure` method can be used to create a sub-account under an existing advanced account through this method. Additional `account_management` or `product_management` services may be provided.
          */
         service?: Schema$AddAccountService[];
+        /**
+         * Optional. If a relationship is created with a provider, you can set an alias for it with this field. The calling user must be an admin on the provider to be able to set an alias.
+         */
+        setAlias?: Schema$SetAliasForRelationship[];
         /**
          * Optional. Users to be added to the account.
          */
@@ -955,6 +992,19 @@ export declare namespace merchantapi_accounts_v1beta {
          */
         allowStrictAvailabilityUpdates?: boolean | null;
     }
+    /**
+     * An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.
+     */
+    export interface Schema$LatLng {
+        /**
+         * The latitude in degrees. It must be in the range [-90.0, +90.0].
+         */
+        latitude?: number | null;
+        /**
+         * The longitude in degrees. It must be in the range [-180.0, +180.0].
+         */
+        longitude?: number | null;
+    }
     /**
      * Collection of information related to the LFP link.
      */
@@ -1581,6 +1631,27 @@ export declare namespace merchantapi_accounts_v1beta {
          */
         provider?: string | null;
     }
+    /**
+     * A radius area that defines the region area.
+     */
+    export interface Schema$RadiusArea {
+        /**
+         * Required. The center of the radius area. It represents a latitude/longitude pair in decimal degrees format.
+         */
+        latLng?: Schema$LatLng;
+        /**
+         * Required. The radius distance of the area.
+         */
+        radius?: number | null;
+        /**
+         * Optional. The unit of the radius.
+         */
+        radiusUnits?: string | null;
+        /**
+         * Required. [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) or the country the radius area applies to.
+         */
+        regionCode?: string | null;
+    }
     /**
      * Shipping rate group definitions. Only the last one is allowed to have an empty `applicable_shipping_labels`, which means "everything else". The other `applicable_shipping_labels` must not overlap.
      */
@@ -1630,6 +1701,10 @@ export declare namespace merchantapi_accounts_v1beta {
          * Optional. A list of postal codes that defines the region area.
          */
         postalCodeArea?: Schema$PostalCodeArea;
+        /**
+         * Optional. A radius area that defines the region area.
+         */
+        radiusArea?: Schema$RadiusArea;
         /**
          * Output only. Indicates if the region is eligible for use in the Regional Inventory configuration.
          */
@@ -1803,6 +1878,19 @@ export declare namespace merchantapi_accounts_v1beta {
          */
         storeConfig?: Schema$StoreConfig;
     }
+    /**
+     * Set an alias for a relationship between a provider and the account to be created.
+     */
+    export interface Schema$SetAliasForRelationship {
+        /**
+         * Required. The unique ID of this account in the provider's system. The value must be unique across all accounts on the platform for this provider.
+         */
+        accountIdAlias?: string | null;
+        /**
+         * Required. The provider of the service. This is a reference to an account such as `providers/123` or `accounts/123`. The same provider must be specified in at least one of the `service` fields.
+         */
+        provider?: string | null;
+    }
     /**
      * The Merchant Center account's [shipping settings](https://support.google.com/merchants/answer/6069284). The `ShippingSettings` resource lets you retrieve and update the shipping settings of your advanced account and all its associated sub-accounts.
      */
@@ -2059,6 +2147,20 @@ export declare namespace merchantapi_accounts_v1beta {
          */
         subtable?: string | null;
     }
+    /**
+     * Settings related to the verification email that is sent after adding a user.
+     */
+    export interface Schema$VerificationMailSettings {
+        /**
+         * Optional. Mode of the verification mail. If not set, the default is `SEND_VERIFICATION_MAIL`.
+         */
+        verificationMailMode?: string | null;
+    }
+    /**
+     * Request message for the `VerifySelf` method.
+     */
+    export interface Schema$VerifySelfRequest {
+    }
     /**
      * A fulfillment warehouse, which stores and handles inventory.
      */
@@ -2185,6 +2287,7 @@ export declare namespace merchantapi_accounts_v1beta {
          *       // {
          *       //   "account": {},
          *       //   "service": [],
+         *       //   "setAlias": [],
          *       //   "user": [],
          *       //   "users": []
          *       // }
@@ -6053,6 +6156,7 @@ export declare namespace merchantapi_accounts_v1beta {
          *       //   "geotargetArea": {},
          *       //   "name": "my_name",
          *       //   "postalCodeArea": {},
+         *       //   "radiusArea": {},
          *       //   "regionalInventoryEligible": false,
          *       //   "shippingEligible": false
          *       // }
@@ -6066,6 +6170,7 @@ export declare namespace merchantapi_accounts_v1beta {
          *   //   "geotargetArea": {},
          *   //   "name": "my_name",
          *   //   "postalCodeArea": {},
+         *   //   "radiusArea": {},
          *   //   "regionalInventoryEligible": false,
          *   //   "shippingEligible": false
          *   // }
@@ -6189,6 +6294,7 @@ export declare namespace merchantapi_accounts_v1beta {
          *   //   "geotargetArea": {},
          *   //   "name": "my_name",
          *   //   "postalCodeArea": {},
+         *   //   "radiusArea": {},
          *   //   "regionalInventoryEligible": false,
          *   //   "shippingEligible": false
          *   // }
@@ -6321,6 +6427,7 @@ export declare namespace merchantapi_accounts_v1beta {
          *       //   "geotargetArea": {},
          *       //   "name": "my_name",
          *       //   "postalCodeArea": {},
+         *       //   "radiusArea": {},
          *       //   "regionalInventoryEligible": false,
          *       //   "shippingEligible": false
          *       // }
@@ -6334,6 +6441,7 @@ export declare namespace merchantapi_accounts_v1beta {
          *   //   "geotargetArea": {},
          *   //   "name": "my_name",
          *   //   "postalCodeArea": {},
+         *   //   "radiusArea": {},
          *   //   "regionalInventoryEligible": false,
          *   //   "shippingEligible": false
          *   // }
@@ -6704,6 +6812,7 @@ export declare namespace merchantapi_accounts_v1beta {
          *   //   "accountAggregation": {},
          *   //   "accountManagement": {},
          *   //   "campaignsManagement": {},
+         *   //   "comparisonShopping": {},
          *   //   "externalAccountId": "my_externalAccountId",
          *   //   "handshake": {},
          *   //   "localListingManagement": {},
@@ -6774,6 +6883,7 @@ export declare namespace merchantapi_accounts_v1beta {
          *   //   "accountAggregation": {},
          *   //   "accountManagement": {},
          *   //   "campaignsManagement": {},
+         *   //   "comparisonShopping": {},
          *   //   "externalAccountId": "my_externalAccountId",
          *   //   "handshake": {},
          *   //   "localListingManagement": {},
@@ -6918,6 +7028,7 @@ export declare namespace merchantapi_accounts_v1beta {
          *   //   "accountAggregation": {},
          *   //   "accountManagement": {},
          *   //   "campaignsManagement": {},
+         *   //   "comparisonShopping": {},
          *   //   "externalAccountId": "my_externalAccountId",
          *   //   "handshake": {},
          *   //   "localListingManagement": {},
@@ -7368,6 +7479,7 @@ export declare namespace merchantapi_accounts_v1beta {
     }
     export class Resource$Accounts$Users {
         context: APIRequestContext;
+        me: Resource$Accounts$Users$Me;
         constructor(context: APIRequestContext);
         /**
          * Creates a Merchant Center account user. Executing this method requires admin access.
@@ -7757,6 +7869,88 @@ export declare namespace merchantapi_accounts_v1beta {
          */
         requestBody?: Schema$User;
     }
+    export class Resource$Accounts$Users$Me {
+        context: APIRequestContext;
+        constructor(context: APIRequestContext);
+        /**
+         * Updates the user that is represented by the caller from pending to verified.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/merchantapi.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const merchantapi = google.merchantapi('accounts_v1beta');
+         *
+         * 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: ['https://www.googleapis.com/auth/content'],
+         *   });
+         *
+         *   // 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 merchantapi.accounts.users.me.verifySelf({
+         *     // Required. The name of the account under which the caller is a user. Format: `accounts/{account\}`
+         *     account: 'accounts/my-account',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {}
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "accessRights": [],
+         *   //   "name": "my_name",
+         *   //   "state": "my_state"
+         *   // }
+         * }
+         *
+         * 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.
+         */
+        verifySelf(params: Params$Resource$Accounts$Users$Me$Verifyself, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        verifySelf(params?: Params$Resource$Accounts$Users$Me$Verifyself, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$User>>;
+        verifySelf(params: Params$Resource$Accounts$Users$Me$Verifyself, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        verifySelf(params: Params$Resource$Accounts$Users$Me$Verifyself, options: MethodOptions | BodyResponseCallback<Schema$User>, callback: BodyResponseCallback<Schema$User>): void;
+        verifySelf(params: Params$Resource$Accounts$Users$Me$Verifyself, callback: BodyResponseCallback<Schema$User>): void;
+        verifySelf(callback: BodyResponseCallback<Schema$User>): void;
+    }
+    export interface Params$Resource$Accounts$Users$Me$Verifyself extends StandardParameters {
+        /**
+         * Required. The name of the account under which the caller is a user. Format: `accounts/{account\}`
+         */
+        account?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$VerifySelfRequest;
+    }
     export class Resource$Termsofservice {
         context: APIRequestContext;
         constructor(context: APIRequestContext);

package/build/accounts_v1beta.js

@@ -2297,8 +2297,10 @@ var merchantapi_accounts_v1beta;
     merchantapi_accounts_v1beta.Resource$Accounts$Termsofserviceagreementstates = Resource$Accounts$Termsofserviceagreementstates;
     class Resource$Accounts$Users {
         context;
+        me;
         constructor(context) {
             this.context = context;
+            this.me = new Resource$Accounts$Users$Me(this.context);
         }
         create(paramsOrCallback, optionsOrCallback, callback) {
             let params = (paramsOrCallback ||
@@ -2462,6 +2464,45 @@ var merchantapi_accounts_v1beta;
         }
     }
     merchantapi_accounts_v1beta.Resource$Accounts$Users = Resource$Accounts$Users;
+    class Resource$Accounts$Users$Me {
+        context;
+        constructor(context) {
+            this.context = context;
+        }
+        verifySelf(paramsOrCallback, optionsOrCallback, callback) {
+            let params = (paramsOrCallback ||
+                {});
+            let options = (optionsOrCallback || {});
+            if (typeof paramsOrCallback === 'function') {
+                callback = paramsOrCallback;
+                params = {};
+                options = {};
+            }
+            if (typeof optionsOrCallback === 'function') {
+                callback = optionsOrCallback;
+                options = {};
+            }
+            const rootUrl = options.rootUrl || 'https://merchantapi.googleapis.com/';
+            const parameters = {
+                options: Object.assign({
+                    url: (rootUrl + '/accounts/v1beta/{+account}/users/me:verifySelf').replace(/([^:]\/)\/+/g, '$1'),
+                    method: 'PATCH',
+                    apiVersion: '',
+                }, options),
+                params,
+                requiredParams: ['account'],
+                pathParams: ['account'],
+                context: this.context,
+            };
+            if (callback) {
+                (0, googleapis_common_1.createAPIRequest)(parameters, callback);
+            }
+            else {
+                return (0, googleapis_common_1.createAPIRequest)(parameters);
+            }
+        }
+    }
+    merchantapi_accounts_v1beta.Resource$Accounts$Users$Me = Resource$Accounts$Users$Me;
     class Resource$Termsofservice {
         context;
         constructor(context) {