@maxim_mazurok/gapi.client.merchantapi-accounts_v1beta 0.0.20250605 → 0.0.20250606

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://merchantapi.googleapis.com/$discovery/rest?version=accounts_v1beta
-// Revision: 20250605
+// Revision: 20250606
 
 /// <reference types="gapi.client" />
 
@@ -35,11 +35,11 @@ declare namespace gapi.client {
       uri?: string;
     }
     interface Accepted {
-      /** The account where the acceptance was recorded. This can be the account itself or, in the case of subaccounts, the advanced account. */
+      /** Required. The account where the acceptance was recorded. This can be the account itself or, in the case of subaccounts, the advanced account. */
       acceptedBy?: string;
-      /** The accepted termsOfService. */
+      /** Required. The accepted termsOfService. */
       termsOfService?: string;
-      /** When set, it states that the accepted `TermsOfService` is only valid until the end of this date (in UTC). A new one must be accepted before then. The information of the required `TermsOfService` is found in the `Required` message. */
+      /** Optional. When set, it states that the accepted `TermsOfService` is only valid until the end of this date (in UTC). A new one must be accepted before then. The information of the required `TermsOfService` is found in the `Required` message. */
       validUntil?: Date;
     }
     interface AcceptTermsOfServiceResponse {
@@ -591,11 +591,11 @@ declare namespace gapi.client {
       seasonalOverrides?: SeasonalOverride[];
     }
     interface PhoneNumber {
-      /** The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123". The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes */
+      /** The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123" The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes */
       e164Number?: string;
       /** The phone number's extension. The extension is not standardized in ITU recommendations, except for being defined as a series of numbers with a maximum length of 40 digits. Other than digits, some other dialing characters such as ',' (indicating a wait) or '#' may be stored here. Note that no regions currently use extensions with short codes, so this field is normally only set in conjunction with an E.164 number. It is held separately from the E.164 number to allow for short code extensions in the future. */
       extension?: string;
-      /** A short code. Reference(s): - https://en.wikipedia.org/wiki/Short_code */
+      /** A short code. Reference(s): - https://wikipedia.org/wiki/Short_code */
       shortCode?: ShortCode;
     }
     interface Pickup {
@@ -736,9 +736,9 @@ declare namespace gapi.client {
       omnichannelSetting?: OmnichannelSetting;
     }
     interface Required {
-      /** The `TermsOfService` that need to be accepted. */
+      /** Required. The `TermsOfService` that need to be accepted. */
       termsOfService?: string;
-      /** Full URL to the terms of service file. This field is the same as `TermsOfService.file_uri`, it is added here for convenience only. */
+      /** Required. Full URL to the terms of service file. This field is the same as `TermsOfService.file_uri`, it is added here for convenience only. */
       tosFileUri?: string;
     }
     interface Requirement {
@@ -802,7 +802,7 @@ declare namespace gapi.client {
       storeConfig?: StoreConfig;
     }
     interface ShippingSettings {
-      /** Required. This field is used for avoid async issue. Make sure shipping setting data didn't change between get call and insert call. The user should do following steps： 1. Set etag field as empty string for initial shipping setting creation. 2. After initial creation, call get method to obtain an etag and current shipping setting data before call insert. 3. Modify to wanted shipping setting information. 4. Call insert method with the wanted shipping setting information with the etag obtained from step 2. 5. If shipping setting data changed between step 2 and step 4. Insert request will fail because the etag changes every time the shipping setting data changes. User should repeate step 2-4 with the new etag. */
+      /** Required. This field helps avoid async issues. It ensures that the shipping setting data doesn't change between the `get` call and the `insert` call. The user should follow these steps: 1. Set the etag field as an empty string for the initial shipping setting creation. 2. After the initial creation, call the `get` method to obtain an etag and the current shipping setting data before calling `insert`. 3. Modify the shipping setting information. 4. Call the `insert` method with the shipping setting information and the etag obtained in step 2. 5. If the shipping setting data changes between step 2 and step 4, the insert request will fail because the etag changes every time the shipping setting data changes. In this case, the user should repeat steps 2-4 with the new etag. */
       etag?: string;
       /** Identifier. The resource name of the shipping settings. Format: `accounts/{account}/shippingSettings`. For example, `accounts/123456/shippingSettings`. */
       name?: string;
@@ -856,15 +856,15 @@ declare namespace gapi.client {
       regionCode?: string;
     }
     interface TermsOfServiceAgreementState {
-      /** The accepted terms of service of this kind and for the associated region_code */
+      /** Optional. The accepted terms of service of this kind and for the associated region_code */
       accepted?: Accepted;
       /** Identifier. The resource name of the terms of service version. Format: `accounts/{account}/termsOfServiceAgreementState/{identifier}` The identifier format is: `{TermsOfServiceKind}-{country}` For example, an identifier could be: `MERCHANT_CENTER-EU` or `MERCHANT_CENTER-US`. */
       name?: string;
-      /** Region code as defined by https://cldr.unicode.org/. This is the country the current state applies to. */
+      /** Required. Region code as defined by https://cldr.unicode.org/. This is the country the current state applies to. */
       regionCode?: string;
-      /** The required terms of service */
+      /** Optional. The required terms of service */
       required?: Required;
-      /** Terms of Service kind associated with the particular version. */
+      /** Required. Terms of Service kind associated with the particular version. */
       termsOfServiceKind?: string;
     }
     interface TimeZone {
@@ -3129,7 +3129,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<TermsOfServiceAgreementState>;
-      /** Retrieves the state of the agreement for the application terms of service. */
+      /** Retrieves the state of the agreement for the application terms of service. Application terms of service covers permissions related to the usage of data provided through Merchant Center, CSS Center, Manufacturer Center, and more. */
       retrieveForApplication(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -3479,7 +3479,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<Account>;
-      /** Lists accounts accessible to the calling user and matching the constraints of the request such as page size or filters. This is not just listing the sub-accounts of an advanced account, but all accounts the calling user has access to including other advanced accounts, linked accounts, standalone accounts and so on. If no filter is provided, then it returns all the accounts the user has access to. This method is eventually consistent, meaning changes such as creating, updating an account or a change of relationships between accounts may not show up in the results immediately. Instead, these changes propagate over a short period, after which the updated information can match the associated predicates. That means, that searching by account name might not return a recently changed account even though it satisfies the predicate. */
+      /** Note: For the `accounts.list` method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the `accounts.listSubaccounts` method, which is more suitable for advanced accounts use case. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.merchantapi-accounts_v1beta",
-  "version": "0.0.20250605",
+  "version": "0.0.20250606",
   "description": "TypeScript typings for Merchant API accounts_v1beta",
   "repository": {
     "type": "git",

package/readme.md

@@ -85,7 +85,7 @@ Retrieves an account from your Merchant Center account. After inserting, updatin
 await gapi.client.merchantapi.accounts.get({name: 'name'});
 
 /*
-Lists accounts accessible to the calling user and matching the constraints of the request such as page size or filters. This is not just listing the sub-accounts of an advanced account, but all accounts the calling user has access to including other advanced accounts, linked accounts, standalone accounts and so on. If no filter is provided, then it returns all the accounts the user has access to. This method is eventually consistent, meaning changes such as creating, updating an account or a change of relationships between accounts may not show up in the results immediately. Instead, these changes propagate over a short period, after which the updated information can match the associated predicates. That means, that searching by account name might not return a recently changed account even though it satisfies the predicate.
+Note: For the `accounts.list` method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the `accounts.listSubaccounts` method, which is more suitable for advanced accounts use case.
 */
 await gapi.client.merchantapi.accounts.list({});