|
321 | 321 | } |
322 | 322 | } |
323 | 323 | }, |
324 | | - "revision": "20240909", |
| 324 | + "revision": "20250108", |
325 | 325 | "rootUrl": "https://merchantapi.googleapis.com/", |
326 | 326 | "schemas": { |
327 | 327 | "DataSource": { |
|
363 | 363 | }, |
364 | 364 | "localInventoryDataSource": { |
365 | 365 | "$ref": "LocalInventoryDataSource", |
366 | | - "description": "Required. The [local inventory](https://support.google.com/merchants/answer/7023001) data source." |
| 366 | + "description": "The [local inventory](https://support.google.com/merchants/answer/7023001) data source." |
| 367 | + }, |
| 368 | + "merchantReviewDataSource": { |
| 369 | + "$ref": "MerchantReviewDataSource", |
| 370 | + "description": "The [merchant review](https://support.google.com/merchants/answer/7045996) data source." |
367 | 371 | }, |
368 | 372 | "name": { |
369 | 373 | "description": "Identifier. The name of the data source. Format: `{datasource.name=accounts/{account}/dataSources/{datasource}}`", |
370 | 374 | "type": "string" |
371 | 375 | }, |
372 | 376 | "primaryProductDataSource": { |
373 | 377 | "$ref": "PrimaryProductDataSource", |
374 | | - "description": "Required. The [primary data source](https://support.google.com/merchants/answer/7439058) for local and online products." |
| 378 | + "description": "The [primary data source](https://support.google.com/merchants/answer/7439058) for local and online products." |
| 379 | + }, |
| 380 | + "productReviewDataSource": { |
| 381 | + "$ref": "ProductReviewDataSource", |
| 382 | + "description": "The [product review](https://support.google.com/merchants/answer/7045996) data source." |
375 | 383 | }, |
376 | 384 | "promotionDataSource": { |
377 | 385 | "$ref": "PromotionDataSource", |
378 | | - "description": "Required. The [promotion](https://support.google.com/merchants/answer/2906014) data source." |
| 386 | + "description": "The [promotion](https://support.google.com/merchants/answer/2906014) data source." |
379 | 387 | }, |
380 | 388 | "regionalInventoryDataSource": { |
381 | 389 | "$ref": "RegionalInventoryDataSource", |
382 | | - "description": "Required. The [regional inventory](https://support.google.com/merchants/answer/7439058) data source." |
| 390 | + "description": "The [regional inventory](https://support.google.com/merchants/answer/7439058) data source." |
383 | 391 | }, |
384 | 392 | "supplementalProductDataSource": { |
385 | 393 | "$ref": "SupplementalProductDataSource", |
386 | | - "description": "Required. The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products." |
| 394 | + "description": "The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products." |
387 | 395 | } |
388 | 396 | }, |
389 | 397 | "type": "object" |
|
491 | 499 | "type": "string" |
492 | 500 | }, |
493 | 501 | "password": { |
494 | | - "description": "Optional. An optional password for fetch url. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).", |
| 502 | + "description": "Optional. An optional password for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).", |
495 | 503 | "type": "string" |
496 | 504 | }, |
497 | 505 | "timeOfDay": { |
|
503 | 511 | "type": "string" |
504 | 512 | }, |
505 | 513 | "username": { |
506 | | - "description": "Optional. An optional user name for fetch url. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).", |
| 514 | + "description": "Optional. An optional user name for fetch_uri. Used for [submitting data sources through SFTP](https://support.google.com/merchants/answer/13813117).", |
507 | 515 | "type": "string" |
508 | 516 | } |
509 | 517 | }, |
|
688 | 696 | }, |
689 | 697 | "type": "object" |
690 | 698 | }, |
| 699 | + "MerchantReviewDataSource": { |
| 700 | + "description": "The merchant review data source.", |
| 701 | + "id": "MerchantReviewDataSource", |
| 702 | + "properties": {}, |
| 703 | + "type": "object" |
| 704 | + }, |
691 | 705 | "PrimaryProductDataSource": { |
692 | 706 | "description": "The primary data source for local and online products.", |
693 | 707 | "id": "PrimaryProductDataSource", |
|
765 | 779 | "CLOUD_RETAIL", |
766 | 780 | "LOCAL_CLOUD_RETAIL", |
767 | 781 | "PRODUCT_REVIEWS", |
768 | | - "MERCHANT_REVIEWS" |
| 782 | + "MERCHANT_REVIEWS", |
| 783 | + "YOUTUBE_CHECKOUT" |
769 | 784 | ], |
770 | 785 | "enumDeprecated": [ |
771 | 786 | false, |
|
784 | 799 | false, |
785 | 800 | false, |
786 | 801 | false, |
| 802 | + false, |
787 | 803 | false |
788 | 804 | ], |
789 | 805 | "enumDescriptions": [ |
|
803 | 819 | "[Cloud retail](https://cloud.google.com/solutions/retail).", |
804 | 820 | "[Local cloud retail](https://cloud.google.com/solutions/retail).", |
805 | 821 | "[Product Reviews](https://support.google.com/merchants/answer/14620732).", |
806 | | - "[Merchant Reviews](https://developers.google.com/merchant-review-feeds)." |
| 822 | + "[Merchant Reviews](https://developers.google.com/merchant-review-feeds).", |
| 823 | + "[YouTube Checkout](" |
807 | 824 | ], |
808 | 825 | "type": "string" |
809 | 826 | } |
810 | 827 | }, |
811 | 828 | "type": "object" |
812 | 829 | }, |
| 830 | + "ProductReviewDataSource": { |
| 831 | + "description": "The product review data source.", |
| 832 | + "id": "ProductReviewDataSource", |
| 833 | + "properties": {}, |
| 834 | + "type": "object" |
| 835 | + }, |
813 | 836 | "ProductStatusChangeMessage": { |
814 | 837 | "description": "The message that the merchant will receive to notify about product status change event", |
815 | 838 | "id": "ProductStatusChangeMessage", |
|
837 | 860 | }, |
838 | 861 | "type": "array" |
839 | 862 | }, |
| 863 | + "expirationTime": { |
| 864 | + "description": "The product expiration time. This field will not bet set if the notification is sent for a product deletion event.", |
| 865 | + "format": "google-datetime", |
| 866 | + "type": "string" |
| 867 | + }, |
840 | 868 | "managingAccount": { |
841 | 869 | "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", |
842 | 870 | "type": "string" |
|
895 | 923 | "type": "object" |
896 | 924 | }, |
897 | 925 | "SupplementalProductDataSource": { |
898 | | - "description": "The supplemental data source for local and online products.", |
| 926 | + "description": "The supplemental data source for local and online products. After creation, you should make sure to link the supplemental product data source into one or more primary product data sources.", |
899 | 927 | "id": "SupplementalProductDataSource", |
900 | 928 | "properties": { |
901 | 929 | "contentLanguage": { |
902 | 930 | "description": "Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.", |
903 | 931 | "type": "string" |
904 | 932 | }, |
905 | 933 | "feedLabel": { |
906 | | - "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 produts without that restriction.", |
| 934 | + "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. The fields must be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.", |
907 | 935 | "type": "string" |
908 | 936 | }, |
909 | 937 | "referencingPrimaryDataSources": { |
|
922 | 950 | "id": "TimeOfDay", |
923 | 951 | "properties": { |
924 | 952 | "hours": { |
925 | | - "description": "Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", |
| 953 | + "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", |
926 | 954 | "format": "int32", |
927 | 955 | "type": "integer" |
928 | 956 | }, |
929 | 957 | "minutes": { |
930 | | - "description": "Minutes of hour of day. Must be from 0 to 59.", |
| 958 | + "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", |
931 | 959 | "format": "int32", |
932 | 960 | "type": "integer" |
933 | 961 | }, |
934 | 962 | "nanos": { |
935 | | - "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.", |
| 963 | + "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", |
936 | 964 | "format": "int32", |
937 | 965 | "type": "integer" |
938 | 966 | }, |
939 | 967 | "seconds": { |
940 | | - "description": "Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.", |
| 968 | + "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.", |
941 | 969 | "format": "int32", |
942 | 970 | "type": "integer" |
943 | 971 | } |
|
0 commit comments