Skip to content

Commit 1e2ee7c

Browse files
yoshi-automationyoshi-automation
committed
feat(merchantapi)!: update the API
BREAKING CHANGE: This release has breaking changes. #### merchantapi:accounts_v1beta The following keys were deleted: - schemas.SeasonalOverride.description - schemas.SeasonalOverride.properties.begin.$ref - schemas.SeasonalOverride.properties.begin.description - schemas.SeasonalOverride.properties.end.$ref - schemas.SeasonalOverride.properties.end.description - schemas.SeasonalOverride.properties.policy.$ref - schemas.SeasonalOverride.properties.policy.description The following keys were added: - resources.accounts.methods.getAutomaticImprovements.description - resources.accounts.methods.getAutomaticImprovements.flatPath - resources.accounts.methods.getAutomaticImprovements.httpMethod - resources.accounts.methods.getAutomaticImprovements.id - resources.accounts.methods.getAutomaticImprovements.parameterOrder - resources.accounts.methods.getAutomaticImprovements.parameters.name.description - resources.accounts.methods.getAutomaticImprovements.parameters.name.location - resources.accounts.methods.getAutomaticImprovements.parameters.name.pattern - resources.accounts.methods.getAutomaticImprovements.parameters.name.required - resources.accounts.methods.getAutomaticImprovements.parameters.name.type - resources.accounts.methods.getAutomaticImprovements.path - resources.accounts.methods.getAutomaticImprovements.response.$ref - resources.accounts.methods.getAutomaticImprovements.scopes - resources.accounts.methods.updateAutomaticImprovements.description - resources.accounts.methods.updateAutomaticImprovements.flatPath - resources.accounts.methods.updateAutomaticImprovements.httpMethod - resources.accounts.methods.updateAutomaticImprovements.id - resources.accounts.methods.updateAutomaticImprovements.parameterOrder - resources.accounts.methods.updateAutomaticImprovements.parameters.name.description - resources.accounts.methods.updateAutomaticImprovements.parameters.name.location - resources.accounts.methods.updateAutomaticImprovements.parameters.name.pattern - resources.accounts.methods.updateAutomaticImprovements.parameters.name.required - resources.accounts.methods.updateAutomaticImprovements.parameters.name.type - resources.accounts.methods.updateAutomaticImprovements.parameters.updateMask.description - resources.accounts.methods.updateAutomaticImprovements.parameters.updateMask.format - resources.accounts.methods.updateAutomaticImprovements.parameters.updateMask.location - resources.accounts.methods.updateAutomaticImprovements.parameters.updateMask.type - resources.accounts.methods.updateAutomaticImprovements.path - resources.accounts.methods.updateAutomaticImprovements.request.$ref - resources.accounts.methods.updateAutomaticImprovements.response.$ref - resources.accounts.methods.updateAutomaticImprovements.scopes - schemas.AddUser.description - schemas.AddUser.id - schemas.AddUser.properties.user.$ref - schemas.AddUser.properties.user.description - schemas.AddUser.properties.userId.description - schemas.AddUser.properties.userId.type - schemas.AddUser.type - schemas.AutomaticImageImprovements.description - schemas.AutomaticImageImprovements.id - schemas.AutomaticImageImprovements.properties.accountImageImprovementsSettings.$ref - schemas.AutomaticImageImprovements.properties.accountImageImprovementsSettings.description - schemas.AutomaticImageImprovements.properties.effectiveAllowAutomaticImageImprovements.description - schemas.AutomaticImageImprovements.properties.effectiveAllowAutomaticImageImprovements.readOnly - schemas.AutomaticImageImprovements.properties.effectiveAllowAutomaticImageImprovements.type - schemas.AutomaticImageImprovements.type - schemas.AutomaticImprovements.description - schemas.AutomaticImprovements.id - schemas.AutomaticImprovements.properties.imageImprovements.$ref - schemas.AutomaticImprovements.properties.imageImprovements.description - schemas.AutomaticImprovements.properties.itemUpdates.$ref - schemas.AutomaticImprovements.properties.itemUpdates.description - schemas.AutomaticImprovements.properties.name.description - schemas.AutomaticImprovements.properties.name.type - schemas.AutomaticImprovements.properties.shippingImprovements.$ref - schemas.AutomaticImprovements.properties.shippingImprovements.description - schemas.AutomaticImprovements.type - schemas.AutomaticItemUpdates.description - schemas.AutomaticItemUpdates.id - schemas.AutomaticItemUpdates.properties.accountItemUpdatesSettings.$ref - schemas.AutomaticItemUpdates.properties.accountItemUpdatesSettings.description - schemas.AutomaticItemUpdates.properties.effectiveAllowAvailabilityUpdates.description - schemas.AutomaticItemUpdates.properties.effectiveAllowAvailabilityUpdates.readOnly - schemas.AutomaticItemUpdates.properties.effectiveAllowAvailabilityUpdates.type - schemas.AutomaticItemUpdates.properties.effectiveAllowConditionUpdates.description - schemas.AutomaticItemUpdates.properties.effectiveAllowConditionUpdates.readOnly - schemas.AutomaticItemUpdates.properties.effectiveAllowConditionUpdates.type - schemas.AutomaticItemUpdates.properties.effectiveAllowPriceUpdates.description - schemas.AutomaticItemUpdates.properties.effectiveAllowPriceUpdates.readOnly - schemas.AutomaticItemUpdates.properties.effectiveAllowPriceUpdates.type - schemas.AutomaticItemUpdates.properties.effectiveAllowStrictAvailabilityUpdates.description - schemas.AutomaticItemUpdates.properties.effectiveAllowStrictAvailabilityUpdates.readOnly - schemas.AutomaticItemUpdates.properties.effectiveAllowStrictAvailabilityUpdates.type - schemas.AutomaticItemUpdates.type - schemas.AutomaticShippingImprovements.description - schemas.AutomaticShippingImprovements.id - schemas.AutomaticShippingImprovements.properties.allowShippingImprovements.description - schemas.AutomaticShippingImprovements.properties.allowShippingImprovements.type - schemas.AutomaticShippingImprovements.type - schemas.CreateAndConfigureAccountRequest.properties.user.description - schemas.CreateAndConfigureAccountRequest.properties.user.items.$ref - schemas.CreateAndConfigureAccountRequest.properties.user.type - schemas.CreateAndConfigureAccountRequest.properties.users.deprecated - schemas.ImageImprovementsAccountLevelSettings.description - schemas.ImageImprovementsAccountLevelSettings.id - schemas.ImageImprovementsAccountLevelSettings.properties.allowAutomaticImageImprovements.description - schemas.ImageImprovementsAccountLevelSettings.properties.allowAutomaticImageImprovements.type - schemas.ImageImprovementsAccountLevelSettings.type - schemas.ItemUpdatesAccountLevelSettings.description - schemas.ItemUpdatesAccountLevelSettings.id - schemas.ItemUpdatesAccountLevelSettings.properties.allowAvailabilityUpdates.description - schemas.ItemUpdatesAccountLevelSettings.properties.allowAvailabilityUpdates.type - schemas.ItemUpdatesAccountLevelSettings.properties.allowConditionUpdates.description - schemas.ItemUpdatesAccountLevelSettings.properties.allowConditionUpdates.type - schemas.ItemUpdatesAccountLevelSettings.properties.allowPriceUpdates.description - schemas.ItemUpdatesAccountLevelSettings.properties.allowPriceUpdates.type - schemas.ItemUpdatesAccountLevelSettings.properties.allowStrictAvailabilityUpdates.description - schemas.ItemUpdatesAccountLevelSettings.properties.allowStrictAvailabilityUpdates.type - schemas.ItemUpdatesAccountLevelSettings.type - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type - schemas.SeasonalOverride.properties.endDate.$ref - schemas.SeasonalOverride.properties.endDate.description - schemas.SeasonalOverride.properties.returnDays.description - schemas.SeasonalOverride.properties.returnDays.format - schemas.SeasonalOverride.properties.returnDays.type - schemas.SeasonalOverride.properties.returnUntilDate.$ref - schemas.SeasonalOverride.properties.returnUntilDate.description - schemas.SeasonalOverride.properties.startDate.$ref - schemas.SeasonalOverride.properties.startDate.description The following keys were changed: - resources.accounts.methods.list.description - resources.accounts.methods.list.parameters.filter.description - schemas.Account.properties.adultContent.description - schemas.CreateAndConfigureAccountRequest.properties.users.description - schemas.ImpactedDestination.properties.reportingContext.enum - schemas.ImpactedDestination.properties.reportingContext.enumDeprecated - schemas.ImpactedDestination.properties.reportingContext.enumDescriptions - schemas.OnlineReturnPolicy.properties.itemConditions.description - schemas.OnlineReturnPolicy.properties.returnMethods.description - schemas.OnlineReturnPolicy.properties.returnShippingFee.description - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description - schemas.Program.description - schemas.User.properties.accessRights.description #### merchantapi:conversions_v1beta The following keys were added: - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description #### merchantapi:datasources_v1beta The following keys were added: - schemas.Destination.description - schemas.Destination.id - schemas.Destination.properties.destination.description - schemas.Destination.properties.destination.enum - schemas.Destination.properties.destination.enumDescriptions - schemas.Destination.properties.destination.type - schemas.Destination.properties.state.description - schemas.Destination.properties.state.enum - schemas.Destination.properties.state.enumDescriptions - schemas.Destination.properties.state.type - schemas.Destination.type - schemas.PrimaryProductDataSource.properties.destinations.description - schemas.PrimaryProductDataSource.properties.destinations.items.$ref - schemas.PrimaryProductDataSource.properties.destinations.type - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - schemas.PrimaryProductDataSource.properties.channel.description - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description #### merchantapi:inventories_v1beta The following keys were added: - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description #### merchantapi:lfp_v1beta The following keys were added: - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description #### merchantapi:notifications_v1beta The following keys were added: - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description #### merchantapi:products_v1beta The following keys were added: - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - resources.accounts.resources.productInputs.methods.insert.parameters.dataSource.description - schemas.DestinationStatus.properties.reportingContext.enum - schemas.DestinationStatus.properties.reportingContext.enumDeprecated - schemas.DestinationStatus.properties.reportingContext.enumDescriptions - schemas.ItemLevelIssue.properties.reportingContext.enum - schemas.ItemLevelIssue.properties.reportingContext.enumDeprecated - schemas.ItemLevelIssue.properties.reportingContext.enumDescriptions - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description #### merchantapi:promotions_v1beta The following keys were added: - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - schemas.Attributes.properties.couponValueType.enumDescriptions - schemas.Attributes.properties.promotionDestinations.items.enumDescriptions - schemas.DestinationStatus.properties.reportingContext.enum - schemas.DestinationStatus.properties.reportingContext.enumDeprecated - schemas.DestinationStatus.properties.reportingContext.enumDescriptions - schemas.ItemLevelIssue.properties.reportingContext.enum - schemas.ItemLevelIssue.properties.reportingContext.enumDeprecated - schemas.ItemLevelIssue.properties.reportingContext.enumDescriptions - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description #### merchantapi:quota_v1beta The following keys were added: - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description #### merchantapi:reports_v1beta The following keys were added: - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - schemas.IssueSeverityPerReportingContext.properties.reportingContext.enum - schemas.IssueSeverityPerReportingContext.properties.reportingContext.enumDeprecated - schemas.IssueSeverityPerReportingContext.properties.reportingContext.enumDescriptions - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description #### merchantapi:reviews_v1beta The following keys were added: - schemas.ProductStatusChangeMessage.properties.eventTime.description - schemas.ProductStatusChangeMessage.properties.eventTime.format - schemas.ProductStatusChangeMessage.properties.eventTime.type The following keys were changed: - schemas.MerchantReview.properties.customAttributes.description - schemas.MerchantReviewAttributes.properties.reviewLanguage.description - schemas.MerchantReviewDestinationStatus.properties.reportingContext.enum - schemas.MerchantReviewDestinationStatus.properties.reportingContext.enumDeprecated - schemas.MerchantReviewDestinationStatus.properties.reportingContext.enumDescriptions - schemas.MerchantReviewItemLevelIssue.properties.reportingContext.enum - schemas.MerchantReviewItemLevelIssue.properties.reportingContext.enumDeprecated - schemas.MerchantReviewItemLevelIssue.properties.reportingContext.enumDescriptions - schemas.ProductChange.properties.newValue.description - schemas.ProductChange.properties.oldValue.description - schemas.ProductChange.properties.regionCode.description - schemas.ProductChange.properties.reportingContext.description - schemas.ProductChange.properties.reportingContext.enum - schemas.ProductChange.properties.reportingContext.enumDeprecated - schemas.ProductChange.properties.reportingContext.enumDescriptions - schemas.ProductReviewDestinationStatus.properties.reportingContext.enum - schemas.ProductReviewDestinationStatus.properties.reportingContext.enumDeprecated - schemas.ProductReviewDestinationStatus.properties.reportingContext.enumDescriptions - schemas.ProductReviewItemLevelIssue.properties.reportingContext.enum - schemas.ProductReviewItemLevelIssue.properties.reportingContext.enumDeprecated - schemas.ProductReviewItemLevelIssue.properties.reportingContext.enumDescriptions - schemas.ProductStatusChangeMessage.properties.expirationTime.description - schemas.ProductStatusChangeMessage.properties.resource.description
1 parent 4cb1662 commit 1e2ee7c

22 files changed

+987
-216
lines changed

‎discovery/merchantapi-accounts_v1beta.json‎

Lines changed: 239 additions & 27 deletions
Large diffs are not rendered by default.

‎discovery/merchantapi-conversions_v1beta.json‎

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -295,7 +295,7 @@
295295
}
296296
}
297297
},
298-
"revision": "20250118",
298+
"revision": "20250311",
299299
"rootUrl": "https://merchantapi.googleapis.com/",
300300
"schemas": {
301301
"AttributionSettings": {
@@ -490,19 +490,19 @@
490490
"id": "ProductChange",
491491
"properties": {
492492
"newValue": {
493-
"description": "The new value of the changed resource or attribute.",
493+
"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
494494
"type": "string"
495495
},
496496
"oldValue": {
497-
"description": "The old value of the changed resource or attribute.",
497+
"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
498498
"type": "string"
499499
},
500500
"regionCode": {
501-
"description": "Countries that have the change (if applicable)",
501+
"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
502502
"type": "string"
503503
},
504504
"reportingContext": {
505-
"description": "Reporting contexts that have the change (if applicable)",
505+
"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
506506
"enum": [
507507
"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
508508
"SHOPPING_ADS",
@@ -516,6 +516,7 @@
516516
"FREE_LISTINGS",
517517
"FREE_LOCAL_LISTINGS",
518518
"FREE_LOCAL_VEHICLE_LISTINGS",
519+
"YOUTUBE_AFFILIATE",
519520
"YOUTUBE_SHOPPING",
520521
"CLOUD_RETAIL",
521522
"LOCAL_CLOUD_RETAIL",
@@ -541,6 +542,7 @@
541542
false,
542543
false,
543544
false,
545+
false,
544546
false
545547
],
546548
"enumDescriptions": [
@@ -556,12 +558,13 @@
556558
"[Free product listings](https://support.google.com/merchants/answer/9199328).",
557559
"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
558560
"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
561+
"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
559562
"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
560563
"[Cloud retail](https://cloud.google.com/solutions/retail).",
561564
"[Local cloud retail](https://cloud.google.com/solutions/retail).",
562565
"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
563566
"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
564-
"[YouTube Checkout]("
567+
"YouTube Checkout ."
565568
],
566569
"type": "string"
567570
}
@@ -595,8 +598,13 @@
595598
},
596599
"type": "array"
597600
},
601+
"eventTime": {
602+
"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
603+
"format": "google-datetime",
604+
"type": "string"
605+
},
598606
"expirationTime": {
599-
"description": "The product expiration time. This field will not bet set if the notification is sent for a product deletion event.",
607+
"description": "Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.",
600608
"format": "google-datetime",
601609
"type": "string"
602610
},
@@ -605,7 +613,7 @@
605613
"type": "string"
606614
},
607615
"resource": {
608-
"description": "The product name. Format: `{product.name=accounts/{account}/products/{product}}`",
616+
"description": "The product name. Format: `accounts/{account}/products/{product}`",
609617
"type": "string"
610618
},
611619
"resourceId": {

‎discovery/merchantapi-datasources_v1beta.json‎

Lines changed: 79 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -321,7 +321,7 @@
321321
}
322322
}
323323
},
324-
"revision": "20250108",
324+
"revision": "20250312",
325325
"rootUrl": "https://merchantapi.googleapis.com/",
326326
"schemas": {
327327
"DataSource": {
@@ -429,6 +429,61 @@
429429
},
430430
"type": "object"
431431
},
432+
"Destination": {
433+
"description": "Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections.",
434+
"id": "Destination",
435+
"properties": {
436+
"destination": {
437+
"description": "[Marketing methods](https://support.google.com/merchants/answer/15130232) (also known as destination) selections.",
438+
"enum": [
439+
"DESTINATION_ENUM_UNSPECIFIED",
440+
"SHOPPING_ADS",
441+
"DISPLAY_ADS",
442+
"LOCAL_INVENTORY_ADS",
443+
"FREE_LISTINGS",
444+
"FREE_LOCAL_LISTINGS",
445+
"YOUTUBE_SHOPPING",
446+
"YOUTUBE_SHOPPING_CHECKOUT",
447+
"YOUTUBE_AFFILIATE",
448+
"FREE_VEHICLE_LISTINGS",
449+
"VEHICLE_ADS",
450+
"CLOUD_RETAIL",
451+
"LOCAL_CLOUD_RETAIL"
452+
],
453+
"enumDescriptions": [
454+
"Not specified.",
455+
"[Shopping ads](https://support.google.com/google-ads/answer/2454022).",
456+
"[Display ads](https://support.google.com/merchants/answer/6069387).",
457+
"[Local inventory ads](https://support.google.com/merchants/answer/3057972).",
458+
"[Free listings](https://support.google.com/merchants/answer/9199328).",
459+
"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
460+
"[YouTube Shopping](https://support.google.com/merchants/answer/12362804).",
461+
"Youtube shopping checkout.",
462+
"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
463+
"[Free vehicle listings](https://support.google.com/merchants/answer/11189169).",
464+
"[Vehicle ads](https://support.google.com/merchants/answer/11189169).",
465+
"[Cloud retail](https://cloud.google.com/solutions/retail).",
466+
"[Local cloud retail](https://cloud.google.com/solutions/retail)."
467+
],
468+
"type": "string"
469+
},
470+
"state": {
471+
"description": "The state of the destination.",
472+
"enum": [
473+
"STATE_UNSPECIFIED",
474+
"ENABLED",
475+
"DISABLED"
476+
],
477+
"enumDescriptions": [
478+
"Not specified.",
479+
"Indicates that the destination is enabled.",
480+
"Indicates that the destination is disabled."
481+
],
482+
"type": "string"
483+
}
484+
},
485+
"type": "object"
486+
},
432487
"Empty": {
433488
"description": "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); }",
434489
"id": "Empty",
@@ -707,7 +762,7 @@
707762
"id": "PrimaryProductDataSource",
708763
"properties": {
709764
"channel": {
710-
"description": "Required. Immutable. Specifies the type of data source channel.",
765+
"description": "Optional. Immutable. Specifies the type of data source channel.",
711766
"enum": [
712767
"CHANNEL_UNSPECIFIED",
713768
"ONLINE_PRODUCTS",
@@ -737,6 +792,13 @@
737792
"$ref": "DefaultRule",
738793
"description": "Optional. Default rule management of the data source. If set, the linked data sources will be replaced."
739794
},
795+
"destinations": {
796+
"description": "Optional. A list of destinations describing where products of the data source can be shown. When retrieving the data source, the list contains all the destinations that can be used for the data source, including the ones that are disabled for the data source but enabled for the account. Only destinations that are enabled on the account, for example through program participation, can be enabled on the data source. If unset, during creation, the destinations will be inherited based on the account level program participation. If set, during creation or update, the data source will be set only for the specified destinations. Updating this field requires at least one destination.",
797+
"items": {
798+
"$ref": "Destination"
799+
},
800+
"type": "array"
801+
},
740802
"feedLabel": {
741803
"description": "Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.",
742804
"type": "string"
@@ -749,19 +811,19 @@
749811
"id": "ProductChange",
750812
"properties": {
751813
"newValue": {
752-
"description": "The new value of the changed resource or attribute.",
814+
"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
753815
"type": "string"
754816
},
755817
"oldValue": {
756-
"description": "The old value of the changed resource or attribute.",
818+
"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
757819
"type": "string"
758820
},
759821
"regionCode": {
760-
"description": "Countries that have the change (if applicable)",
822+
"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
761823
"type": "string"
762824
},
763825
"reportingContext": {
764-
"description": "Reporting contexts that have the change (if applicable)",
826+
"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
765827
"enum": [
766828
"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
767829
"SHOPPING_ADS",
@@ -775,6 +837,7 @@
775837
"FREE_LISTINGS",
776838
"FREE_LOCAL_LISTINGS",
777839
"FREE_LOCAL_VEHICLE_LISTINGS",
840+
"YOUTUBE_AFFILIATE",
778841
"YOUTUBE_SHOPPING",
779842
"CLOUD_RETAIL",
780843
"LOCAL_CLOUD_RETAIL",
@@ -800,6 +863,7 @@
800863
false,
801864
false,
802865
false,
866+
false,
803867
false
804868
],
805869
"enumDescriptions": [
@@ -815,12 +879,13 @@
815879
"[Free product listings](https://support.google.com/merchants/answer/9199328).",
816880
"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
817881
"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
882+
"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
818883
"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
819884
"[Cloud retail](https://cloud.google.com/solutions/retail).",
820885
"[Local cloud retail](https://cloud.google.com/solutions/retail).",
821886
"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
822887
"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
823-
"[YouTube Checkout]("
888+
"YouTube Checkout ."
824889
],
825890
"type": "string"
826891
}
@@ -860,8 +925,13 @@
860925
},
861926
"type": "array"
862927
},
928+
"eventTime": {
929+
"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
930+
"format": "google-datetime",
931+
"type": "string"
932+
},
863933
"expirationTime": {
864-
"description": "The product expiration time. This field will not bet set if the notification is sent for a product deletion event.",
934+
"description": "Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.",
865935
"format": "google-datetime",
866936
"type": "string"
867937
},
@@ -870,7 +940,7 @@
870940
"type": "string"
871941
},
872942
"resource": {
873-
"description": "The product name. Format: `{product.name=accounts/{account}/products/{product}}`",
943+
"description": "The product name. Format: `accounts/{account}/products/{product}`",
874944
"type": "string"
875945
},
876946
"resourceId": {

‎discovery/merchantapi-inventories_v1beta.json‎

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -300,7 +300,7 @@
300300
}
301301
}
302302
},
303-
"revision": "20241119",
303+
"revision": "20250311",
304304
"rootUrl": "https://merchantapi.googleapis.com/",
305305
"schemas": {
306306
"CustomAttribute": {
@@ -467,19 +467,19 @@
467467
"id": "ProductChange",
468468
"properties": {
469469
"newValue": {
470-
"description": "The new value of the changed resource or attribute.",
470+
"description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
471471
"type": "string"
472472
},
473473
"oldValue": {
474-
"description": "The old value of the changed resource or attribute.",
474+
"description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)",
475475
"type": "string"
476476
},
477477
"regionCode": {
478-
"description": "Countries that have the change (if applicable)",
478+
"description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.",
479479
"type": "string"
480480
},
481481
"reportingContext": {
482-
"description": "Reporting contexts that have the change (if applicable)",
482+
"description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)",
483483
"enum": [
484484
"REPORTING_CONTEXT_ENUM_UNSPECIFIED",
485485
"SHOPPING_ADS",
@@ -493,6 +493,7 @@
493493
"FREE_LISTINGS",
494494
"FREE_LOCAL_LISTINGS",
495495
"FREE_LOCAL_VEHICLE_LISTINGS",
496+
"YOUTUBE_AFFILIATE",
496497
"YOUTUBE_SHOPPING",
497498
"CLOUD_RETAIL",
498499
"LOCAL_CLOUD_RETAIL",
@@ -518,6 +519,7 @@
518519
false,
519520
false,
520521
false,
522+
false,
521523
false
522524
],
523525
"enumDescriptions": [
@@ -533,12 +535,13 @@
533535
"[Free product listings](https://support.google.com/merchants/answer/9199328).",
534536
"[Free local product listings](https://support.google.com/merchants/answer/9825611).",
535537
"[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).",
538+
"[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).",
536539
"[YouTube Shopping](https://support.google.com/merchants/answer/13478370).",
537540
"[Cloud retail](https://cloud.google.com/solutions/retail).",
538541
"[Local cloud retail](https://cloud.google.com/solutions/retail).",
539542
"[Product Reviews](https://support.google.com/merchants/answer/14620732).",
540543
"[Merchant Reviews](https://developers.google.com/merchant-review-feeds).",
541-
"[YouTube Checkout]("
544+
"YouTube Checkout ."
542545
],
543546
"type": "string"
544547
}
@@ -572,8 +575,13 @@
572575
},
573576
"type": "array"
574577
},
578+
"eventTime": {
579+
"description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.",
580+
"format": "google-datetime",
581+
"type": "string"
582+
},
575583
"expirationTime": {
576-
"description": "The product expiration time. This field will not bet set if the notification is sent for a product deletion event.",
584+
"description": "Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.",
577585
"format": "google-datetime",
578586
"type": "string"
579587
},
@@ -582,7 +590,7 @@
582590
"type": "string"
583591
},
584592
"resource": {
585-
"description": "The product name. Format: `{product.name=accounts/{account}/products/{product}}`",
593+
"description": "The product name. Format: `accounts/{account}/products/{product}`",
586594
"type": "string"
587595
},
588596
"resourceId": {

0 commit comments

Comments
 (0)