Skip to content

Commit 237c2dd

Browse files
fix(merchantapi): update the API
#### merchantapi:accounts_v1beta The following keys were changed: - resources.accounts.resources.homepage.methods.claim.description - schemas.ClaimHomepageRequest.properties.overwrite.description - schemas.Program.description
1 parent 16b7d7e commit 237c2dd

File tree

2 files changed

+7
-7
lines changed

2 files changed

+7
-7
lines changed

discovery/merchantapi-accounts_v1beta.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -602,7 +602,7 @@
602602
"homepage": {
603603
"methods": {
604604
"claim": {
605-
"description": "Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the merchant is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message will be returned: * PERMISSION_DENIED: user doesn't have the necessary permissions on this MC account; * FAILED_PRECONDITION: - The account is not a Merchant Center account; - MC account doesn't have a homepage; - claiming failed (in this case the error message will contain more details).",
605+
"description": "Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the merchant is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message is returned: * PERMISSION_DENIED: User doesn't have the necessary permissions on this Merchant Center account. * FAILED_PRECONDITION: - The account is not a Merchant Center account. - Merchant Center account doesn't have a homepage. - Claiming failed (in this case the error message contains more details).",
606606
"flatPath": "accounts/v1beta/accounts/{accountsId}/homepage:claim",
607607
"httpMethod": "POST",
608608
"id": "merchantapi.accounts.homepage.claim",
@@ -1728,7 +1728,7 @@
17281728
}
17291729
}
17301730
},
1731-
"revision": "20250430",
1731+
"revision": "20250505",
17321732
"rootUrl": "https://merchantapi.googleapis.com/",
17331733
"schemas": {
17341734
"AcceptTermsOfServiceResponse": {
@@ -2270,7 +2270,7 @@
22702270
"id": "ClaimHomepageRequest",
22712271
"properties": {
22722272
"overwrite": {
2273-
"description": "Optional. When set to `true`, this option removes any existing claim on the requested website and replaces it with a claim from the account that makes the request.",
2273+
"description": "Optional. When set to `true`, this option removes any existing claim on the requested website from any other account to the account making the request, effectively replacing the previous claim.",
22742274
"type": "boolean"
22752275
}
22762276
},
@@ -3472,7 +3472,7 @@
34723472
"type": "object"
34733473
},
34743474
"Program": {
3475-
"description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to merchant accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/topic/9240261?ref_topic=7257954,7259405,&sjid=796648681813264022-EU) program, which enables products from a merchant's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`",
3475+
"description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to merchant accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a merchant's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`",
34763476
"id": "Program",
34773477
"properties": {
34783478
"activeRegionCodes": {

src/apis/merchantapi/accounts_v1beta.ts

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -537,7 +537,7 @@ export namespace merchantapi_accounts_v1beta {
537537
*/
538538
export interface Schema$ClaimHomepageRequest {
539539
/**
540-
* Optional. When set to `true`, this option removes any existing claim on the requested website and replaces it with a claim from the account that makes the request.
540+
* Optional. When set to `true`, this option removes any existing claim on the requested website from any other account to the account making the request, effectively replacing the previous claim.
541541
*/
542542
overwrite?: boolean | null;
543543
}
@@ -1275,7 +1275,7 @@ export namespace merchantapi_accounts_v1beta {
12751275
resourceType?: string | null;
12761276
}
12771277
/**
1278-
* Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to merchant accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/topic/9240261?ref_topic=7257954,7259405,&sjid=796648681813264022-EU) program, which enables products from a merchant's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`
1278+
* Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to merchant accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a merchant's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`
12791279
*/
12801280
export interface Schema$Program {
12811281
/**
@@ -3546,7 +3546,7 @@ export namespace merchantapi_accounts_v1beta {
35463546
}
35473547

35483548
/**
3549-
* Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the merchant is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message will be returned: * PERMISSION_DENIED: user doesn't have the necessary permissions on this MC account; * FAILED_PRECONDITION: - The account is not a Merchant Center account; - MC account doesn't have a homepage; - claiming failed (in this case the error message will contain more details).
3549+
* Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the merchant is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message is returned: * PERMISSION_DENIED: User doesn't have the necessary permissions on this Merchant Center account. * FAILED_PRECONDITION: - The account is not a Merchant Center account. - Merchant Center account doesn't have a homepage. - Claiming failed (in this case the error message contains more details).
35503550
*
35513551
* @param params - Parameters for request
35523552
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.

0 commit comments

Comments
 (0)