From e70c638dec8995bdc3fe7cd976e13b77d977ca15 Mon Sep 17 00:00:00 2001 From: Justin Beckwith Date: Mon, 5 Oct 2020 13:15:02 -0700 Subject: [PATCH] feat(content)!: update the API BREAKING CHANGE: This release has breaking changes. #### content:v2 The following keys were changed: - schemas.AccountAddress.properties.country.description - schemas.AccountStatusAccountLevelIssue.properties.destination.description #### content:v2.1 The following keys were deleted: - schemas.ProductStatusDestinationStatus.properties.approvedCountrys.description - schemas.ProductStatusDestinationStatus.properties.approvedCountrys.items.type - schemas.ProductStatusDestinationStatus.properties.approvedCountrys.type - schemas.ProductStatusDestinationStatus.properties.disapprovedCountrys.description - schemas.ProductStatusDestinationStatus.properties.disapprovedCountrys.items.type - schemas.ProductStatusDestinationStatus.properties.disapprovedCountrys.type - schemas.ProductStatusDestinationStatus.properties.pendingCountrys.description - schemas.ProductStatusDestinationStatus.properties.pendingCountrys.items.type - schemas.ProductStatusDestinationStatus.properties.pendingCountrys.type - schemas.ProductStatusItemLevelIssue.properties.applicableCountrys.description - schemas.ProductStatusItemLevelIssue.properties.applicableCountrys.items.type - schemas.ProductStatusItemLevelIssue.properties.applicableCountrys.type The following keys were added: - schemas.OrderreturnsRefundOperation.properties.paymentType.description - schemas.OrderreturnsRefundOperation.properties.paymentType.type - schemas.Product.properties.shoppingAdsExcludedCountries.description - schemas.Product.properties.shoppingAdsExcludedCountries.items.type - schemas.Product.properties.shoppingAdsExcludedCountries.type - schemas.ProductStatusDestinationStatus.properties.approvedCountries.description - schemas.ProductStatusDestinationStatus.properties.approvedCountries.items.type - schemas.ProductStatusDestinationStatus.properties.approvedCountries.type - schemas.ProductStatusDestinationStatus.properties.disapprovedCountries.description - schemas.ProductStatusDestinationStatus.properties.disapprovedCountries.items.type - schemas.ProductStatusDestinationStatus.properties.disapprovedCountries.type - schemas.ProductStatusDestinationStatus.properties.pendingCountries.description - schemas.ProductStatusDestinationStatus.properties.pendingCountries.items.type - schemas.ProductStatusDestinationStatus.properties.pendingCountries.type - schemas.ProductStatusItemLevelIssue.properties.applicableCountries.description - schemas.ProductStatusItemLevelIssue.properties.applicableCountries.items.type - schemas.ProductStatusItemLevelIssue.properties.applicableCountries.type The following keys were changed: - resources.localinventory.methods.insert.description - resources.orderreturns.methods.list.parameters.shipmentStates.enum - resources.orderreturns.methods.list.parameters.shipmentStates.enumDescriptions - schemas.AccountAddress.properties.country.description - schemas.AccountStatusAccountLevelIssue.properties.destination.description - schemas.OrderreturnsRefundOperation.properties.fullRefund.description - schemas.OrderreturnsRefundOperation.properties.partialRefund.description --- discovery/content-v2.1.json | 35 ++++++++++++++++++++++++----------- discovery/content-v2.json | 8 ++++---- src/apis/content/v2.1.ts | 29 ++++++++++++++++++++--------- src/apis/content/v2.ts | 4 ++-- 4 files changed, 50 insertions(+), 26 deletions(-) diff --git a/discovery/content-v2.1.json b/discovery/content-v2.1.json index 58fd1f47c6..7dae2f467a 100644 --- a/discovery/content-v2.1.json +++ b/discovery/content-v2.1.json @@ -15,7 +15,7 @@ "description": "Manages product items, inventory, and Merchant Center accounts for Google Shopping.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/shopping-content", - "etag": "\"-2NioU2H8y8siEzrBOV_qzRI6kQ/-cxFi5x9QP7nGEy7qxpdbRvhe9g\"", + "etag": "\"-2NioU2H8y8siEzrBOV_qzRI6kQ/hzL4Pf5JdJer2F_gaxG6dg1Snv0\"", "icons": { "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" @@ -1344,7 +1344,7 @@ ] }, "insert": { - "description": "Update the local inventory of a product in your Merchant Center account.", + "description": "Updates the local inventory of a product in your Merchant Center account.", "httpMethod": "POST", "id": "content.localinventory.insert", "parameterOrder": [ @@ -1688,6 +1688,7 @@ "enum": [ "completed", "new", + "pending", "shipped", "undeliverable" ], @@ -1695,6 +1696,7 @@ "", "", "", + "", "" ], "location": "query", @@ -3745,7 +3747,7 @@ } } }, - "revision": "20200805", + "revision": "20200922", "rootUrl": "https://www.googleapis.com/", "schemas": { "Account": { @@ -3838,7 +3840,7 @@ "id": "AccountAddress", "properties": { "country": { - "description": "CLDR country code (e.g. \"US\").", + "description": "CLDR country code (e.g. \"US\"). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.", "type": "string" }, "locality": { @@ -3987,7 +3989,7 @@ "type": "string" }, "destination": { - "description": "The destination the issue applies to.", + "description": "The destination the issue applies to. If this field is empty then the issue applies to all available destinations.", "type": "string" }, "detail": { @@ -7512,12 +7514,16 @@ "id": "OrderreturnsRefundOperation", "properties": { "fullRefund": { - "description": "If true, the item will be fully refunded.", + "description": "If true, the item will be fully refunded. Allowed only when payment_type is FOP. Merchant can choose this refund option to indicate the full remaining amount of corresponding object to be refunded to the customer via FOP.", "type": "boolean" }, "partialRefund": { "$ref": "OrderreturnsPartialRefund", - "description": "If this is set, the item will be partially refunded." + "description": "If this is set, the item will be partially refunded. Merchant can choose this refund option to specify the customized amount that to be refunded to the customer." + }, + "paymentType": { + "description": "The payment way of issuing refund. Default value is ORIGINAL_FOP if not set.", + "type": "string" }, "reasonText": { "description": "The explanation of the reason.", @@ -9409,6 +9415,13 @@ "$ref": "ProductShippingDimension", "description": "Width of the item for shipping." }, + "shoppingAdsExcludedCountries": { + "description": "List of country codes (ISO 3166-1 alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in MC feed settings.", + "items": { + "type": "string" + }, + "type": "array" + }, "sizeSystem": { "description": "System in which the size is specified. Recommended for apparel items.", "type": "string" @@ -9625,7 +9638,7 @@ "ProductStatusDestinationStatus": { "id": "ProductStatusDestinationStatus", "properties": { - "approvedCountrys": { + "approvedCountries": { "description": "List of country codes (ISO 3166-1 alpha-2) where the offer is approved.", "items": { "type": "string" @@ -9636,14 +9649,14 @@ "description": "The name of the destination", "type": "string" }, - "disapprovedCountrys": { + "disapprovedCountries": { "description": "List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved.", "items": { "type": "string" }, "type": "array" }, - "pendingCountrys": { + "pendingCountries": { "description": "List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval.", "items": { "type": "string" @@ -9660,7 +9673,7 @@ "ProductStatusItemLevelIssue": { "id": "ProductStatusItemLevelIssue", "properties": { - "applicableCountrys": { + "applicableCountries": { "description": "List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.", "items": { "type": "string" diff --git a/discovery/content-v2.json b/discovery/content-v2.json index 0e1fc4a6d9..7c3dbf6cd2 100644 --- a/discovery/content-v2.json +++ b/discovery/content-v2.json @@ -15,7 +15,7 @@ "description": "Manages product items, inventory, and Merchant Center accounts for Google Shopping.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/shopping-content", - "etag": "\"-2NioU2H8y8siEzrBOV_qzRI6kQ/LoJS2PHXpFWLupj-kOBpv7_os1o\"", + "etag": "\"-2NioU2H8y8siEzrBOV_qzRI6kQ/FZya_uIA39DIS2igEhjy5Fo5-W4\"", "icons": { "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" @@ -3162,7 +3162,7 @@ } } }, - "revision": "20200805", + "revision": "20200922", "rootUrl": "https://www.googleapis.com/", "schemas": { "Account": { @@ -3246,7 +3246,7 @@ "id": "AccountAddress", "properties": { "country": { - "description": "CLDR country code (e.g. \"US\").", + "description": "CLDR country code (e.g. \"US\"). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.", "type": "string" }, "locality": { @@ -3398,7 +3398,7 @@ "type": "string" }, "destination": { - "description": "The destination the issue applies to.", + "description": "The destination the issue applies to. If this field is empty then the issue applies to all available destinations.", "type": "string" }, "detail": { diff --git a/src/apis/content/v2.1.ts b/src/apis/content/v2.1.ts index cba9fd67d6..4977043ffe 100644 --- a/src/apis/content/v2.1.ts +++ b/src/apis/content/v2.1.ts @@ -214,7 +214,7 @@ export namespace content_v2_1 { } export interface Schema$AccountAddress { /** - * CLDR country code (e.g. "US"). + * CLDR country code (e.g. "US"). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA. */ country?: string | null; /** @@ -492,7 +492,7 @@ export namespace content_v2_1 { */ country?: string | null; /** - * The destination the issue applies to. + * The destination the issue applies to. If this field is empty then the issue applies to all available destinations. */ destination?: string | null; /** @@ -2784,13 +2784,17 @@ export namespace content_v2_1 { } export interface Schema$OrderreturnsRefundOperation { /** - * If true, the item will be fully refunded. + * If true, the item will be fully refunded. Allowed only when payment_type is FOP. Merchant can choose this refund option to indicate the full remaining amount of corresponding object to be refunded to the customer via FOP. */ fullRefund?: boolean | null; /** - * If this is set, the item will be partially refunded. + * If this is set, the item will be partially refunded. Merchant can choose this refund option to specify the customized amount that to be refunded to the customer. */ partialRefund?: Schema$OrderreturnsPartialRefund; + /** + * The payment way of issuing refund. Default value is ORIGINAL_FOP if not set. + */ + paymentType?: string | null; /** * The explanation of the reason. */ @@ -4140,6 +4144,10 @@ export namespace content_v2_1 { * Width of the item for shipping. */ shippingWidth?: Schema$ProductShippingDimension; + /** + * List of country codes (ISO 3166-1 alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in MC feed settings. + */ + shoppingAdsExcludedCountries?: string[] | null; /** * Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value (see size definition). */ @@ -4389,7 +4397,7 @@ export namespace content_v2_1 { /** * List of country codes (ISO 3166-1 alpha-2) where the offer is approved. */ - approvedCountrys?: string[] | null; + approvedCountries?: string[] | null; /** * The name of the destination */ @@ -4397,11 +4405,11 @@ export namespace content_v2_1 { /** * List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved. */ - disapprovedCountrys?: string[] | null; + disapprovedCountries?: string[] | null; /** * List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval. */ - pendingCountrys?: string[] | null; + pendingCountries?: string[] | null; /** * Destination approval status in `targetCountry` of the offer. */ @@ -4485,7 +4493,7 @@ export namespace content_v2_1 { /** * List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer. */ - applicableCountrys?: string[] | null; + applicableCountries?: string[] | null; /** * The attribute's name, if the issue is caused by a single attribute. */ @@ -11988,7 +11996,7 @@ export namespace content_v2_1 { /** * content.localinventory.insert - * @desc Update the local inventory of a product in your Merchant Center account. + * @desc Updates the local inventory of a product in your Merchant Center account. * @example * // Before running the sample: * // - Enable the API at: @@ -18726,6 +18734,7 @@ export namespace content_v2_1 { * // "shippingLength": {}, * // "shippingWeight": {}, * // "shippingWidth": {}, + * // "shoppingAdsExcludedCountries": [], * // "sizeSystem": "my_sizeSystem", * // "sizeType": "my_sizeType", * // "sizes": [], @@ -18936,6 +18945,7 @@ export namespace content_v2_1 { * // "shippingLength": {}, * // "shippingWeight": {}, * // "shippingWidth": {}, + * // "shoppingAdsExcludedCountries": [], * // "sizeSystem": "my_sizeSystem", * // "sizeType": "my_sizeType", * // "sizes": [], @@ -19022,6 +19032,7 @@ export namespace content_v2_1 { * // "shippingLength": {}, * // "shippingWeight": {}, * // "shippingWidth": {}, + * // "shoppingAdsExcludedCountries": [], * // "sizeSystem": "my_sizeSystem", * // "sizeType": "my_sizeType", * // "sizes": [], diff --git a/src/apis/content/v2.ts b/src/apis/content/v2.ts index be20ca82d3..736bffd8c5 100644 --- a/src/apis/content/v2.ts +++ b/src/apis/content/v2.ts @@ -194,7 +194,7 @@ export namespace content_v2 { } export interface Schema$AccountAddress { /** - * CLDR country code (e.g. "US"). + * CLDR country code (e.g. "US"). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA. */ country?: string | null; /** @@ -450,7 +450,7 @@ export namespace content_v2 { */ country?: string | null; /** - * The destination the issue applies to. + * The destination the issue applies to. If this field is empty then the issue applies to all available destinations. */ destination?: string | null; /**