Skip to content

Commit b42712e

Browse files
yoshi-automationsofisl
authored andcommitted
feat(merchantapi)!: update the API
BREAKING CHANGE: This release has breaking changes. #### merchantapi:accounts_v1beta The following keys were added: - resources.accounts.methods.getDeveloperRegistration.description - resources.accounts.methods.getDeveloperRegistration.flatPath - resources.accounts.methods.getDeveloperRegistration.httpMethod - resources.accounts.methods.getDeveloperRegistration.id - resources.accounts.methods.getDeveloperRegistration.parameterOrder - resources.accounts.methods.getDeveloperRegistration.parameters.name.description - resources.accounts.methods.getDeveloperRegistration.parameters.name.location - resources.accounts.methods.getDeveloperRegistration.parameters.name.pattern - resources.accounts.methods.getDeveloperRegistration.parameters.name.required - resources.accounts.methods.getDeveloperRegistration.parameters.name.type - resources.accounts.methods.getDeveloperRegistration.path - resources.accounts.methods.getDeveloperRegistration.response.$ref - resources.accounts.methods.getDeveloperRegistration.scopes - resources.accounts.resources.developerRegistration.methods.registerGcp.description - resources.accounts.resources.developerRegistration.methods.registerGcp.flatPath - resources.accounts.resources.developerRegistration.methods.registerGcp.httpMethod - resources.accounts.resources.developerRegistration.methods.registerGcp.id - resources.accounts.resources.developerRegistration.methods.registerGcp.parameterOrder - resources.accounts.resources.developerRegistration.methods.registerGcp.parameters.name.description - resources.accounts.resources.developerRegistration.methods.registerGcp.parameters.name.location - resources.accounts.resources.developerRegistration.methods.registerGcp.parameters.name.pattern - resources.accounts.resources.developerRegistration.methods.registerGcp.parameters.name.required - resources.accounts.resources.developerRegistration.methods.registerGcp.parameters.name.type - resources.accounts.resources.developerRegistration.methods.registerGcp.path - resources.accounts.resources.developerRegistration.methods.registerGcp.request.$ref - resources.accounts.resources.developerRegistration.methods.registerGcp.response.$ref - resources.accounts.resources.developerRegistration.methods.registerGcp.scopes - resources.accounts.resources.developerRegistration.methods.unregisterGcp.description - resources.accounts.resources.developerRegistration.methods.unregisterGcp.flatPath - resources.accounts.resources.developerRegistration.methods.unregisterGcp.httpMethod - resources.accounts.resources.developerRegistration.methods.unregisterGcp.id - resources.accounts.resources.developerRegistration.methods.unregisterGcp.parameterOrder - resources.accounts.resources.developerRegistration.methods.unregisterGcp.parameters.name.description - resources.accounts.resources.developerRegistration.methods.unregisterGcp.parameters.name.location - resources.accounts.resources.developerRegistration.methods.unregisterGcp.parameters.name.pattern - resources.accounts.resources.developerRegistration.methods.unregisterGcp.parameters.name.required - resources.accounts.resources.developerRegistration.methods.unregisterGcp.parameters.name.type - resources.accounts.resources.developerRegistration.methods.unregisterGcp.path - resources.accounts.resources.developerRegistration.methods.unregisterGcp.request.$ref - resources.accounts.resources.developerRegistration.methods.unregisterGcp.response.$ref - resources.accounts.resources.developerRegistration.methods.unregisterGcp.scopes - schemas.DeveloperRegistration.description - schemas.DeveloperRegistration.id - schemas.DeveloperRegistration.properties.gcpIds.description - schemas.DeveloperRegistration.properties.gcpIds.items.type - schemas.DeveloperRegistration.properties.gcpIds.readOnly - schemas.DeveloperRegistration.properties.gcpIds.type - schemas.DeveloperRegistration.properties.name.description - schemas.DeveloperRegistration.properties.name.type - schemas.DeveloperRegistration.type - schemas.RegisterGCPRequest.description - schemas.RegisterGCPRequest.id - schemas.RegisterGCPRequest.properties.developerEmail.description - schemas.RegisterGCPRequest.properties.developerEmail.type - schemas.RegisterGCPRequest.type - schemas.UnregisterGCPRequest.description - schemas.UnregisterGCPRequest.id - schemas.UnregisterGCPRequest.type The following keys were changed: - resources.accounts.resources.onlineReturnPolicies.methods.patch.parameters.updateMask.description - schemas.OnlineReturnPolicy.properties.label.description #### merchantapi:datasources_v1beta The following keys were deleted: - schemas.RegionalInventoryDataSource.description The following keys were changed: - schemas.LocalInventoryDataSource.description #### merchantapi:products_v1beta The following keys were added: - schemas.Attributes.properties.gtin.deprecated - schemas.Attributes.properties.gtins.description - schemas.Attributes.properties.gtins.items.type - schemas.Attributes.properties.gtins.type The following keys were changed: - schemas.Attributes.properties.gtin.description #### merchantapi:reviews_v1beta The following keys were added: - schemas.ProductReviewAttributes.properties.isIncentivizedReview.description - schemas.ProductReviewAttributes.properties.isIncentivizedReview.type - schemas.ProductReviewAttributes.properties.isVerifiedPurchase.description - schemas.ProductReviewAttributes.properties.isVerifiedPurchase.type
1 parent c94055f commit b42712e

8 files changed

+665
-16
lines changed

discovery/merchantapi-accounts_v1beta.json

Lines changed: 124 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -180,6 +180,31 @@
180180
"https://www.googleapis.com/auth/content"
181181
]
182182
},
183+
"getDeveloperRegistration": {
184+
"description": "Retrieves a developer registration for a merchant.",
185+
"flatPath": "accounts/v1beta/accounts/{accountsId}/developerRegistration",
186+
"httpMethod": "GET",
187+
"id": "merchantapi.accounts.getDeveloperRegistration",
188+
"parameterOrder": [
189+
"name"
190+
],
191+
"parameters": {
192+
"name": {
193+
"description": "Required. The `name` (ID) of the developer registration.",
194+
"location": "path",
195+
"pattern": "^accounts/[^/]+/developerRegistration$",
196+
"required": true,
197+
"type": "string"
198+
}
199+
},
200+
"path": "accounts/v1beta/{+name}",
201+
"response": {
202+
"$ref": "DeveloperRegistration"
203+
},
204+
"scopes": [
205+
"https://www.googleapis.com/auth/content"
206+
]
207+
},
183208
"list": {
184209
"description": "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.",
185210
"flatPath": "accounts/v1beta/accounts",
@@ -536,6 +561,66 @@
536561
}
537562
}
538563
},
564+
"developerRegistration": {
565+
"methods": {
566+
"registerGcp": {
567+
"description": "Registers the GCP used for the API call to the shopping account passed in the request. Will create a user with an \"API developer\" and add the \"developer_email\" as a contact with \"API notifications\" email preference on.",
568+
"flatPath": "accounts/v1beta/accounts/{accountsId}/developerRegistration:registerGcp",
569+
"httpMethod": "POST",
570+
"id": "merchantapi.accounts.developerRegistration.registerGcp",
571+
"parameterOrder": [
572+
"name"
573+
],
574+
"parameters": {
575+
"name": {
576+
"description": "Required. The name of the developer registration to be created for the merchant account that the GCP will be registered with. Format: `accounts/{account}/developerRegistration`",
577+
"location": "path",
578+
"pattern": "^accounts/[^/]+/developerRegistration$",
579+
"required": true,
580+
"type": "string"
581+
}
582+
},
583+
"path": "accounts/v1beta/{+name}:registerGcp",
584+
"request": {
585+
"$ref": "RegisterGCPRequest"
586+
},
587+
"response": {
588+
"$ref": "DeveloperRegistration"
589+
},
590+
"scopes": [
591+
"https://www.googleapis.com/auth/content"
592+
]
593+
},
594+
"unregisterGcp": {
595+
"description": "Unregister the calling GCP from the calling shopping account. Note that the GCP will still be able to access the API for at most 1 day from the unregister succussful call.",
596+
"flatPath": "accounts/v1beta/accounts/{accountsId}/developerRegistration:unregisterGcp",
597+
"httpMethod": "POST",
598+
"id": "merchantapi.accounts.developerRegistration.unregisterGcp",
599+
"parameterOrder": [
600+
"name"
601+
],
602+
"parameters": {
603+
"name": {
604+
"description": "Required. The name of the developer registration to be created for the merchant account that the GCP will be registered with. Format: `accounts/{account}/developerRegistration`",
605+
"location": "path",
606+
"pattern": "^accounts/[^/]+/developerRegistration$",
607+
"required": true,
608+
"type": "string"
609+
}
610+
},
611+
"path": "accounts/v1beta/{+name}:unregisterGcp",
612+
"request": {
613+
"$ref": "UnregisterGCPRequest"
614+
},
615+
"response": {
616+
"$ref": "Empty"
617+
},
618+
"scopes": [
619+
"https://www.googleapis.com/auth/content"
620+
]
621+
}
622+
}
623+
},
539624
"emailPreferences": {
540625
"methods": {
541626
"getEmailPreferences": {
@@ -1194,7 +1279,7 @@
11941279
"type": "string"
11951280
},
11961281
"updateMask": {
1197-
"description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `accept_defective_only` - `accept_exchange` - `item_conditions` - `policy` - `process_refund_days` - `restocking_fee` - `return_methods` - `return_policy_uri` - `return_shipping_fee`",
1282+
"description": "Optional. Only support updating the entire OnlineReturnPolicy message. For update_mask, always use `*`.",
11981283
"format": "google-fieldmask",
11991284
"location": "query",
12001285
"type": "string"
@@ -2226,7 +2311,7 @@
22262311
}
22272312
}
22282313
},
2229-
"revision": "20250628",
2314+
"revision": "20250710",
22302315
"rootUrl": "https://merchantapi.googleapis.com/",
22312316
"schemas": {
22322317
"About": {
@@ -3117,6 +3202,25 @@
31173202
},
31183203
"type": "object"
31193204
},
3205+
"DeveloperRegistration": {
3206+
"description": "Represents a developer registration owned by a Merchant account.",
3207+
"id": "DeveloperRegistration",
3208+
"properties": {
3209+
"gcpIds": {
3210+
"description": "Output only. The GCP ids attached to this developer registration",
3211+
"items": {
3212+
"type": "string"
3213+
},
3214+
"readOnly": true,
3215+
"type": "array"
3216+
},
3217+
"name": {
3218+
"description": "Identifier. The `name` (ID) of the developer registration. Generated by the Content API upon creation of a new `DeveloperRegistration`. The `account` represents the merchant ID of the merchant that owns the registration.",
3219+
"type": "string"
3220+
}
3221+
},
3222+
"type": "object"
3223+
},
31203224
"DisableProgramRequest": {
31213225
"description": "Request message for the DisableProgram method.",
31223226
"id": "DisableProgramRequest",
@@ -4107,7 +4211,7 @@
41074211
"type": "array"
41084212
},
41094213
"label": {
4110-
"description": "Required. Immutable. This field represents the unique user-defined label of the return policy. It is important to note that the same label cannot be used in different return policies for the same country. Unless a product specifies a specific label attribute, policies will be automatically labeled as 'default'. To assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.",
4214+
"description": "Optional. Immutable. This field represents the unique user-defined label of the return policy for the given country. It is important to note that the same label cannot be used in different return policies for the same country. If not given, policies will be automatically treated as the 'default' for the country. When using label, you are creating an exception policy in that country to assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.",
41114215
"type": "string"
41124216
},
41134217
"name": {
@@ -4662,6 +4766,17 @@
46624766
},
46634767
"type": "object"
46644768
},
4769+
"RegisterGCPRequest": {
4770+
"description": "Request message for the RegisterGCP method.",
4771+
"id": "RegisterGCPRequest",
4772+
"properties": {
4773+
"developerEmail": {
4774+
"description": "Immutable. If the developer email provided is associated with a user in the merchant account provided, the user will be updated to have \"API developer\" access type and the email preference corresponding to that user will be updated to have the new \"API notifications\" preference. If the developer email provided is not associated with any user we will just add it as a contact. The email preference corresponding to that contact will have the new \"API notifications\" preference",
4775+
"type": "string"
4776+
}
4777+
},
4778+
"type": "object"
4779+
},
46654780
"RejectAccountServiceRequest": {
46664781
"description": "Request to reject an account service.",
46674782
"id": "RejectAccountServiceRequest",
@@ -5153,6 +5268,12 @@
51535268
"properties": {},
51545269
"type": "object"
51555270
},
5271+
"UnregisterGCPRequest": {
5272+
"description": "Request message for the UnregisterGCP method.",
5273+
"id": "UnregisterGCPRequest",
5274+
"properties": {},
5275+
"type": "object"
5276+
},
51565277
"UriSettings": {
51575278
"description": "URL settings for cart or checkout URL.",
51585279
"id": "UriSettings",

discovery/merchantapi-datasources_v1beta.json

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -321,7 +321,7 @@
321321
}
322322
}
323323
},
324-
"revision": "20250621",
324+
"revision": "20250710",
325325
"rootUrl": "https://merchantapi.googleapis.com/",
326326
"schemas": {
327327
"DataSource": {
@@ -737,7 +737,7 @@
737737
"type": "object"
738738
},
739739
"LocalInventoryDataSource": {
740-
"description": "The local inventory data source.",
740+
"description": "The local inventory data source type is only available for file inputs and can't be used to create API local inventory data sources.",
741741
"id": "LocalInventoryDataSource",
742742
"properties": {
743743
"contentLanguage": {
@@ -978,7 +978,6 @@
978978
"type": "object"
979979
},
980980
"RegionalInventoryDataSource": {
981-
"description": "The regional inventory data source.",
982981
"id": "RegionalInventoryDataSource",
983982
"properties": {
984983
"contentLanguage": {

discovery/merchantapi-products_v1beta.json

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -281,7 +281,7 @@
281281
}
282282
}
283283
},
284-
"revision": "20250621",
284+
"revision": "20250710",
285285
"rootUrl": "https://merchantapi.googleapis.com/",
286286
"schemas": {
287287
"Attributes": {
@@ -454,6 +454,14 @@
454454
"type": "string"
455455
},
456456
"gtin": {
457+
"deprecated": true,
458+
"description": "Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs. Deprecated: Use `gtins` instead.",
459+
"items": {
460+
"type": "string"
461+
},
462+
"type": "array"
463+
},
464+
"gtins": {
457465
"description": "Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs.",
458466
"items": {
459467
"type": "string"

discovery/merchantapi-reviews_v1beta.json

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -356,7 +356,7 @@
356356
}
357357
}
358358
},
359-
"revision": "20250621",
359+
"revision": "20250710",
360360
"rootUrl": "https://merchantapi.googleapis.com/",
361361
"schemas": {
362362
"CustomAttribute": {
@@ -952,10 +952,18 @@
952952
},
953953
"type": "array"
954954
},
955+
"isIncentivizedReview": {
956+
"description": "Optional. Indicates whether the review is incentivized.",
957+
"type": "boolean"
958+
},
955959
"isSpam": {
956960
"description": "Optional. Indicates whether the review is marked as spam in the publisher's system.",
957961
"type": "boolean"
958962
},
963+
"isVerifiedPurchase": {
964+
"description": "Optional. Indicates whether the reviewer's purchase is verified.",
965+
"type": "boolean"
966+
},
959967
"maxRating": {
960968
"description": "Optional. The maximum possible number for the rating. The value of the max rating must be greater than the value of the min attribute.",
961969
"format": "int64",

0 commit comments

Comments
 (0)