google-api-python-client 2.194.0__py3-none-any.whl → 2.196.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/merchantapi.products_v1.json

@@ -124,7 +124,7 @@
 "type": "string"
 },
 "name": {
-"description": "Required. The name of the product input to delete. Format: `accounts/{account}/productInputs/{productInput}` The {productInput} segment is a unique identifier for the product. This identifier must be unique within a merchant account and generally follows the structure: `content_language~feed_label~offer_id`. Example: `en~US~sku123` For legacy local products, the structure is: `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123` The format of the {productInput} segment in the URL is automatically detected by the server, supporting two options: 1. **Encoded Format**: The `{productInput}` segment is an unpadded base64url encoded string (RFC 4648 Section 5). The decoded string must result in the `content_language~feed_label~offer_id` structure. This encoding MUST be used if any part of the product identifier (like `offer_id`) contains characters such as `/`, `%`, or `~`. * Example: To represent the product ID `en~US~sku/123`, the `{productInput}` segment must be the base64url encoding of this string, which is `ZW5-VVN-c2t1LzEyMw`. The full resource name for the product would be `accounts/123/productInputs/ZW5-VVN-c2t1LzEyMw`. 2. **Plain Format**: The `{productInput}` segment is the tilde-separated string `content_language~feed_label~offer_id`. This format is suitable only when `content_language`, `feed_label`, and `offer_id` do not contain URL-problematic characters like `/`, `%`, or `~`. We recommend using the **Encoded Format** for all product IDs to ensure correct parsing, especially those containing special characters. The presence of tilde (`~`) characters in the `{productInput}` segment is used to differentiate between the two formats.",
+"description": "Required. The name of the product input to delete. Format: `accounts/{account}/productInputs/{productInput}` The {productInput} segment is a unique identifier for the product. This identifier must be unique within a merchant account and generally follows the structure: `content_language~feed_label~offer_id`. Example: `en~US~sku123` For legacy local products, the structure is: `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123` The format of the {productInput} segment in the URL is automatically detected by the server, supporting two options: 1. **Encoded Format**: The `{productInput}` segment is an unpadded base64url encoded string (RFC 4648 Section 5). The decoded string must result in the `content_language~feed_label~offer_id` structure. This encoding MUST be used if any part of the product identifier (like `offer_id`) contains characters such as `/`, `%`, or `~`. * Example: To represent the product ID `en~US~sku/123`, the `{productInput}` segment must be the unpadded base64url encoding of this string, which is `ZW5-VVN-c2t1LzEyMw`. The full resource name for the product would be `accounts/123/productInputs/ZW5-VVN-c2t1LzEyMw`. 2. **Plain Format**: The `{productInput}` segment is the tilde-separated string `content_language~feed_label~offer_id`. This format is suitable only when `content_language`, `feed_label`, and `offer_id` do not contain URL-problematic characters like `/`, `%`, or `~`. We recommend using the **Encoded Format** for all product IDs to ensure correct parsing, especially those containing special characters. The presence of tilde (`~`) characters in the `{productInput}` segment is used to differentiate between the two formats.",
 "location": "path",
 "pattern": "^accounts/[^/]+/productInputs/[^/]+$",
 "required": true,
@@ -187,7 +187,7 @@
 "type": "string"
 },
 "name": {
-"description": "Identifier. The name of the product. Format: `accounts/{account}/productInputs/{productinput}` The {productinput} segment is a unique identifier for the product. This identifier must be unique within a merchant account and generally follows the structure: `content_language~feed_label~offer_id`. Example: `en~US~sku123` For legacy local products, the structure is: `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123` The format of the {productinput} segment in the URL is automatically detected by the server, supporting two options: 1. **Encoded Format**: The `{productinput}` segment is an unpadded base64url encoded string (RFC 4648 Section 5). The decoded string must result in the `content_language~feed_label~offer_id` structure. This encoding MUST be used if any part of the product identifier (like `offer_id`) contains characters such as `/`, `%`, or `~`. * Example: To represent the product ID `en~US~sku/123`, the `{productinput}` segment must be the base64url encoding of this string, which is `ZW5-VVN-c2t1LzEyMw`. The full resource name for the product would be `accounts/123/productInputs/ZW5-VVN-c2t1LzEyMw`. 2. **Plain Format**: The `{productinput}` segment is the tilde-separated string `content_language~feed_label~offer_id`. This format is suitable only when `content_language`, `feed_label`, and `offer_id` do not contain URL-problematic characters like `/`, `%`, or `~`. We recommend using the **Encoded Format** for all product IDs to ensure correct parsing, especially those containing special characters. The presence of tilde (`~`) characters in the `{productinput}` segment is used to differentiate between the two formats.",
+"description": "Identifier. The name of the product. Format: `accounts/{account}/productInputs/{productinput}` The {productinput} segment is a unique identifier for the product. This identifier must be unique within a merchant account and generally follows the structure: `content_language~feed_label~offer_id`. Example: `en~US~sku123` For legacy local products, the structure is: `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123` The format of the {productinput} segment in the URL is automatically detected by the server, supporting two options: 1. **Encoded Format**: The `{productinput}` segment is an unpadded base64url encoded string (RFC 4648 Section 5). The decoded string must result in the `content_language~feed_label~offer_id` structure. This encoding MUST be used if any part of the product identifier (like `offer_id`) contains characters such as `/`, `%`, or `~`. * Example: To represent the product ID `en~US~sku/123`, the `{productinput}` segment must be the unpadded base64url encoding of this string, which is `ZW5-VVN-c2t1LzEyMw`. The full resource name for the product would be `accounts/123/productInputs/ZW5-VVN-c2t1LzEyMw`. 2. **Plain Format**: The `{productinput}` segment is the tilde-separated string `content_language~feed_label~offer_id`. This format is suitable only when `content_language`, `feed_label`, and `offer_id` do not contain URL-problematic characters like `/`, `%`, or `~`. We recommend using the **Encoded Format** for all product IDs to ensure correct parsing, especially those containing special characters. The presence of tilde (`~`) characters in the `{productinput}` segment is used to differentiate between the two formats.",
 "location": "path",
 "pattern": "^accounts/[^/]+/productInputs/[^/]+$",
 "required": true,
@@ -281,7 +281,7 @@
 }
 }
 },
-"revision": "20260327",
+"revision": "20260501",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "AutomatedDiscounts": {
@@ -631,6 +631,30 @@
 },
 "type": "object"
 },
+"Co2Emissions": {
+"description": "The co2 emission of the vehicle.",
+"id": "Co2Emissions",
+"properties": {
+"unit": {
+"description": "The unit of the co2 emission.",
+"enum": [
+"UNIT_UNSPECIFIED",
+"GPERKM"
+],
+"enumDescriptions": [
+"Unspecified unit.",
+"Grams per km."
+],
+"type": "string"
+},
+"value": {
+"description": "The co2 emission value.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
 "CustomAttribute": {
 "description": "A message that represents custom attributes. Exactly one of `value` or `group_values` must not be empty.",
 "id": "CustomAttribute",
@@ -757,6 +781,30 @@ false
 "properties": {},
 "type": "object"
 },
+"EnergyConsumption": {
+"description": "The energy consumption of the vehicle.",
+"id": "EnergyConsumption",
+"properties": {
+"unit": {
+"description": "The unit of the energy consumption.",
+"enum": [
+"UNIT_UNSPECIFIED",
+"KWHPER100KM"
+],
+"enumDescriptions": [
+"Unspecified unit.",
+"Kilowatt hours per 100 km."
+],
+"type": "string"
+},
+"value": {
+"description": "The energy consumption value.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
 "FreeShippingThreshold": {
 "description": "Conditions to be met for a product to have free shipping.",
 "id": "FreeShippingThreshold",
@@ -772,6 +820,32 @@ false
 },
 "type": "object"
 },
+"FuelConsumption": {
+"description": "The fuel consumption of the vehicle.",
+"id": "FuelConsumption",
+"properties": {
+"unit": {
+"description": "The unit of the fuel consumption.",
+"enum": [
+"UNIT_UNSPECIFIED",
+"LPER100KM",
+"KGPER100KM"
+],
+"enumDescriptions": [
+"Unspecified unit.",
+"Liter per 100 km.",
+"Kilograms per 100 km."
+],
+"type": "string"
+},
+"value": {
+"description": "The fuel consumption value.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
 "HandlingCutoffTime": {
 "description": "Configuration for offer or offer-country level shipping handling cutoff time.",
 "id": "HandlingCutoffTime",
@@ -1011,6 +1085,32 @@ false
 },
 "type": "object"
 },
+"Mileage": {
+"description": "The mileage of the vehicle.",
+"id": "Mileage",
+"properties": {
+"unit": {
+"description": "The unit of the mileage.",
+"enum": [
+"UNIT_UNSPECIFIED",
+"MILES",
+"KM"
+],
+"enumDescriptions": [
+"Unspecified unit.",
+"Miles.",
+"Kilometers."
+],
+"type": "string"
+},
+"value": {
+"description": "The distance value.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Price": {
 "description": "The price represented as a number and currency.",
 "id": "Price",
@@ -1036,6 +1136,11 @@ false
 "description": "Output only. The automated discounts information for the product.",
 "readOnly": true
 },
+"base64EncodedName": {
+"description": "Output only. The **unpadded base64url encoded name** of the product. Format: `accounts/{account}/products/{product}` where the last section `product` is the unpadded base64url encoding of the `content_language~feed_label~offer_id` name. Example: `accounts/123/products/ZW5-VVN-c2t1LzEyMw` for the decoded product name `accounts/123/products/en~US~sku/123`. This field can be used directly as input to the API methods that require the product name to be encoded if it contains special characters, for example [`GetProduct`](https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.products/get).",
+"readOnly": true,
+"type": "string"
+},
 "contentLanguage": {
 "description": "Output only. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.",
 "readOnly": true,
@@ -1171,6 +1276,78 @@ false
 "format": "google-datetime",
 "type": "string"
 },
+"bodyStyle": {
+"description": "The [body style](https://support.google.com/google-ads/answer/14157085) of the vehicle.",
+"enum": [
+"VEHICLE_BODY_STYLE_UNSPECIFIED",
+"ATV_SPORT",
+"ATV_TOURING",
+"ATV_UTILITY",
+"ATV_YOUTH",
+"CITY_CAR",
+"CLASS_A_MOTORHOME",
+"CLASS_B_MOTORHOME",
+"CLASS_C_MOTORHOME",
+"COMPACT_SUV",
+"CONVERTIBLE",
+"COUPE",
+"CROSSOVER",
+"FIFTH_WHEEL",
+"FULL_SIZE_VAN",
+"HATCHBACK",
+"LIMOUSINE",
+"MINIVAN",
+"NOTCHBACK",
+"POP_UP_CAMPER",
+"SEDAN",
+"SIDE_BY_SIDE",
+"STATION_WAGON",
+"SUV",
+"TRAVEL_TRAILER",
+"TRUCK",
+"TRUCK_CAMPER",
+"UTE",
+"UTV_RECREATIONAL_UTILITY",
+"UTV_SPORT",
+"UTV_UTILITY",
+"UTV_YOUTH"
+],
+"enumDescriptions": [
+"Unspecified vehicle body style.",
+"ATV Sport.",
+"ATV Touring.",
+"ATV Utility.",
+"ATV Youth.",
+"City car.",
+"Class A motorhome.",
+"Class B motorhome.",
+"Class C motorhome.",
+"Compact SUV.",
+"Convertible.",
+"Coupe.",
+"Crossover.",
+"Fifth wheel.",
+"Full size van.",
+"Hatchback.",
+"Limousine.",
+"Minivan.",
+"Notchback.",
+"Pop up camper.",
+"Sedan.",
+"Side by side.",
+"Station wagon.",
+"SUV.",
+"Travel trailer.",
+"Truck.",
+"Truck camper.",
+"Ute.",
+"UTV Recreational utility.",
+"UTV Sport.",
+"UTV Utility.",
+"UTV Youth."
+],
+"type": "string"
+},
 "brand": {
 "description": "[Brand](https://support.google.com/merchants/answer/6324351) of the item. For example, \"Google\".",
 "type": "string"
@@ -1193,6 +1370,10 @@ false
 },
 "type": "array"
 },
+"certifiedPreOwned": {
+"description": "Whether the vehicle is OEM [certified pre-owned](https://support.google.com/google-ads/answer/14156475).",
+"type": "boolean"
+},
 "cloudExportAdditionalProperties": {
 "description": "Extra fields to export to the Cloud Retail program.",
 "items": {
@@ -1200,6 +1381,10 @@ false
 },
 "type": "array"
 },
+"co2Emissions": {
+"$ref": "Co2Emissions",
+"description": "The [co2 emission](https://support.google.com/google-ads/answer/14546146) of the vehicle."
+},
 "color": {
 "description": "[Color](https://support.google.com/merchants/answer/6324487) of the item. For example, \"red\".",
 "type": "string"
@@ -1244,6 +1429,10 @@ false
 "description": "[Custom label 4](https://support.google.com/merchants/answer/6324473) for custom grouping of items in a Shopping campaign.",
 "type": "string"
 },
+"dateFirstRegistered": {
+"description": "The date the vehicle was first registered. Format: `YYYY-MM`. See the [Date first registered](https://support.google.com/google-ads/answer/14546138) for more information.",
+"type": "string"
+},
 "description": {
 "description": "Description of the item.",
 "type": "string"
@@ -1277,6 +1466,48 @@ false
 "format": "double",
 "type": "number"
 },
+"electricRange": {
+"$ref": "Mileage",
+"description": "The [electric range](https://support.google.com/google-ads/answer/15162232) of the vehicle in miles/kms."
+},
+"emissionsStandard": {
+"description": "The [emission standard](https://support.google.com/google-ads/answer/14869021) of the vehicle.",
+"enum": [
+"EMISSIONS_STANDARD_UNSPECIFIED",
+"ZERO_EMISSIONS",
+"EURO1",
+"EURO2",
+"EURO3",
+"EURO4",
+"EURO5",
+"EURO5B",
+"EURO6",
+"EURO6C",
+"EURO6D",
+"EURO6D_TEMP",
+"EURO6E"
+],
+"enumDescriptions": [
+"Unspecified emission standard.",
+"Zero emissions.",
+"Euro 1.",
+"Euro 2.",
+"Euro 3.",
+"Euro 4.",
+"Euro 5.",
+"Euro 5b.",
+"Euro 6.",
+"Euro 6c.",
+"Euro 6d.",
+"Euro 6d-TEMP.",
+"Euro 6e."
+],
+"type": "string"
+},
+"energyConsumption": {
+"$ref": "EnergyConsumption",
+"description": "The [energy consumption](https://support.google.com/google-ads/answer/14546149) of the vehicle."
+},
 "energyEfficiencyClass": {
 "description": "The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.",
 "enum": [
@@ -1307,6 +1538,34 @@ false
 ],
 "type": "string"
 },
+"engine": {
+"description": "The [engine](https://support.google.com/google-ads/answer/14156068) type of the vehicle.",
+"enum": [
+"ENGINE_TYPE_UNSPECIFIED",
+"GASOLINE",
+"DIESEL",
+"ELECTRIC",
+"HYBRID",
+"PLUG_IN_HYBRID",
+"NATURAL_GAS",
+"LPG",
+"METHANE",
+"OTHER"
+],
+"enumDescriptions": [
+"Unspecified engine type.",
+"Gasoline.",
+"Diesel.",
+"Electric.",
+"Hybrid.",
+"Plug-in hybrid.",
+"Natural gas.",
+"LPG.",
+"Methane.",
+"Other."
+],
+"type": "string"
+},
 "excludedDestinations": {
 "description": "The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.",
 "items": {
@@ -1360,6 +1619,14 @@ false
 },
 "type": "array"
 },
+"fuelConsumption": {
+"$ref": "FuelConsumption",
+"description": "The [fuel consumption](https://support.google.com/google-ads/answer/14543580) of the vehicle."
+},
+"fuelConsumptionDischargedBattery": {
+"$ref": "FuelConsumption",
+"description": "The fuel consumption of the vehicle when the hybrid battery is discharged. See the [Help Center article](https://support.google.com/google-ads/answer/15162033) for more information."
+},
 "gender": {
 "description": "Target [gender](https://support.google.com/merchants/answer/6324479) of the item.",
 "enum": [
@@ -1381,7 +1648,7 @@ false
 "type": "string"
 },
 "gtins": {
-"description": "Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. You can provide up to 10 GTINs.",
+"description": "Global Trade Item Numbers ([GTIN](https://support.google.com/merchants/answer/6324461)) of the item. You can provide up to 10 GTINs.",
 "items": {
 "type": "string"
 },
@@ -1520,6 +1787,10 @@ false
 "$ref": "Price",
 "description": "Maximum retail price (MRP) of the item. Applicable to India only."
 },
+"mileage": {
+"$ref": "Mileage",
+"description": "The number of miles/kms on the vehicle. See the [Mileage](https://support.google.com/google-ads/answer/14156166) for more information."
+},
 "minEnergyEfficiencyClass": {
 "description": "The [energy efficiency class](https://support.google.com/merchants/answer/7562785) as defined in EU directive 2010/30/EU.",
 "enum": [
@@ -1555,6 +1826,13 @@ false
 "format": "int64",
 "type": "string"
 },
+"minimumOrderValues": {
+"description": "The [minimum value](https://support.google.com/merchants/answer/16989009) in the cart before a customer can initiate checkout. Supports multiple minimum order values. Different minimum order values can be specified per country, service and surface. Maximum entries: 100.",
+"items": {
+"$ref": "ProductMinimumOrderValue"
+},
+"type": "array"
+},
 "mobileLink": {
 "description": "URL for the mobile-optimized version of your item's landing page.",
 "type": "string"
@@ -1563,8 +1841,12 @@ false
 "description": "[Link template](https://support.google.com/merchants/answer/13870216) for business hosted local storefront optimized for mobile devices.",
 "type": "string"
 },
+"model": {
+"description": "The [Model](https://support.google.com/google-ads/answer/14154511) of the vehicle, such as `LX`, `EX`, and others.",
+"type": "string"
+},
 "mpn": {
-"description": "Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/188494#mpn)) of the item.",
+"description": "Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/6324482)) of the item.",
 "type": "string"
 },
 "multipack": {
@@ -1835,6 +2117,10 @@ false
 "description": "The transit time label of the product, used to group product in account-level transit time tables.",
 "type": "string"
 },
+"trim": {
+"description": "The [Trim](https://support.google.com/google-ads/answer/14154176) of the vehicle model, such as `S`, `SV`, `SL` and others.",
+"type": "string"
+},
 "unitPricingBaseMeasure": {
 "$ref": "UnitPricingBaseMeasure",
 "description": "The preference of the denominator of the unit price."
@@ -1843,9 +2129,65 @@ false
 "$ref": "UnitPricingMeasure",
 "description": "The measure and dimension of an item."
 },
+"vehicleAllInPrice": {
+"$ref": "Price",
+"description": "The all-in advertised price for a vehicle, which includes costs for the following \u2013 any accessories attached to the vehicle, environmental levies, extra warranty, fuel, freight, pre-delivery inspection (PDI), dealer fees for handling licensing, provincial regulatory fees, miscellaneous dealer charges for security etching and nitrogen tire fill, and factory-to-customer or dealer-to-customer discounts or incentives. See the [Vehicle all-in price](https://support.google.com/google-ads/answer/14156981) for more information."
+},
+"vehicleExpenses": {
+"$ref": "Price",
+"description": "The miscellaneous expenses like insurance and registration fees of the vehicle. See the [Vehicle expenses](https://support.google.com/google-ads/answer/15957154) for more information."
+},
+"vehicleMandatoryInspectionIncluded": {
+"description": "Whether the vehicle is sold with mandatory inspection and maintenance performed before delivery. See the [Vehicle mandatory inspection included](https://support.google.com/google-ads/answer/15956630) for more information.`",
+"type": "boolean"
+},
+"vehicleMsrp": {
+"$ref": "Price",
+"description": "The MSRP (Manufacturer Suggested Retail Price) for the vehicle in its current configuration. See the [Vehicle MSRP](https://support.google.com/google-ads/answer/14154171) for more information."
+},
+"vehiclePriceType": {
+"description": "The [price type](https://support.google.com/google-ads/answer/14592783) of the vehicle.",
+"enum": [
+"VEHICLE_PRICE_TYPE_UNSPECIFIED",
+"ALL_IN_PRICE",
+"DRIVE_AWAY_PRICE",
+"ESTIMATED_DRIVE_AWAY_PRICE",
+"EXCLUDING_GOVERNMENT_CHARGES_PRICE",
+"VEHICLE_BASE_PRICE"
+],
+"enumDescriptions": [
+"Unspecified vehicle price type.",
+"All in price.",
+"Drive away price.",
+"Estimated drive away price.",
+"Excluding government charges price.",
+"Vehicle base price."
+],
+"type": "string"
+},
+"videoLinks": {
+"description": "Optional. A list of video URLs for the item. Use this attribute to provide more visuals for your product beyond your image attributes. See the [Help Center article](https://support.google.com/merchants/answer/15216925) for more information.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"vin": {
+"description": "The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle.",
+"type": "string"
+},
 "virtualModelLink": {
 "description": "URL of the 3D image of the item. See the [Help Center article](https://support.google.com/merchants/answer/13674896) for more information.",
 "type": "string"
+},
+"warranty": {
+"$ref": "Warranty",
+"description": "The [warranty](https://support.google.com/google-ads/answer/15957626) of the vehicle."
+},
+"year": {
+"description": "The [Year](https://support.google.com/google-ads/answer/14152816) of the vehicle model.",
+"format": "int64",
+"type": "string"
 }
 },
 "type": "object"
@@ -2033,6 +2375,16 @@ false
 "description": "This resource represents input data you submit for a product, not the processed product that you see in Merchant Center, in Shopping ads, or across Google surfaces. Product inputs, rules and supplemental data source data are combined to create the processed Product. For more information, see [Manage products](/merchant/api/guides/products/overview). Required product input attributes to pass data validation checks are primarily defined in the [Products Data Specification](https://support.google.com/merchants/answer/188494). The following attributes are required: feedLabel, contentLanguage and offerId. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved. All fields in the product input and its sub-messages match the English name of their corresponding attribute in the [Products Data Specification](https://support.google.com/merchants/answer/188494) with [some exceptions](https://support.google.com/merchants/answer/7052112). The following reference documentation lists the field names in the **camelCase** casing style while the Products Data Specification lists the names in the **snake_case** casing style.",
 "id": "ProductInput",
 "properties": {
+"base64EncodedName": {
+"description": "Output only. The **unpadded base64url encoded name** of the product input. Format: `accounts/{account}/productInputs/{productinput}` where the last section `productinput` is the unpadded base64url encoding of the `content_language~feed_label~offer_id` name. Example: `accounts/123/productInputs/ZW5-VVN-c2t1LzEyMw` for the decoded product input name `accounts/123/productInputs/en~US~sku/123`. This field can be used directly as input to the API methods that require the product input name to be encoded if it contains special characters, for example [`GetProductInput`](https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.productInputs/get).",
+"readOnly": true,
+"type": "string"
+},
+"base64EncodedProduct": {
+"description": "Output only. The **unpadded base64url encoded name** of the processed product. Format: `accounts/{account}/products/{product}` where the last section `product` is the unpadded base64url encoding of the `content_language~feed_label~offer_id` name. Example: `accounts/123/products/ZW5-VVN-c2t1LzEyMw` for the decoded product name `accounts/123/products/en~US~sku/123`. This field can be used directly as input to the API methods that require the product name to be encoded if it contains special characters, for example [`GetProduct`](https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.products/get).",
+"readOnly": true,
+"type": "string"
+},
 "contentLanguage": {
 "description": "Required. Immutable. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the product.",
 "type": "string"
@@ -2053,7 +2405,7 @@ false
 "type": "boolean"
 },
 "name": {
-"description": "Identifier. The name of the product. Format: `accounts/{account}/productInputs/{productinput}` The {productinput} segment is a unique identifier for the product. This identifier must be unique within a merchant account and generally follows the structure: `content_language~feed_label~offer_id`. Example: `en~US~sku123` For legacy local products, the structure is: `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123` The format of the {productinput} segment in the URL is automatically detected by the server, supporting two options: 1. **Encoded Format**: The `{productinput}` segment is an unpadded base64url encoded string (RFC 4648 Section 5). The decoded string must result in the `content_language~feed_label~offer_id` structure. This encoding MUST be used if any part of the product identifier (like `offer_id`) contains characters such as `/`, `%`, or `~`. * Example: To represent the product ID `en~US~sku/123`, the `{productinput}` segment must be the base64url encoding of this string, which is `ZW5-VVN-c2t1LzEyMw`. The full resource name for the product would be `accounts/123/productInputs/ZW5-VVN-c2t1LzEyMw`. 2. **Plain Format**: The `{productinput}` segment is the tilde-separated string `content_language~feed_label~offer_id`. This format is suitable only when `content_language`, `feed_label`, and `offer_id` do not contain URL-problematic characters like `/`, `%`, or `~`. We recommend using the **Encoded Format** for all product IDs to ensure correct parsing, especially those containing special characters. The presence of tilde (`~`) characters in the `{productinput}` segment is used to differentiate between the two formats.",
+"description": "Identifier. The name of the product. Format: `accounts/{account}/productInputs/{productinput}` The {productinput} segment is a unique identifier for the product. This identifier must be unique within a merchant account and generally follows the structure: `content_language~feed_label~offer_id`. Example: `en~US~sku123` For legacy local products, the structure is: `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123` The format of the {productinput} segment in the URL is automatically detected by the server, supporting two options: 1. **Encoded Format**: The `{productinput}` segment is an unpadded base64url encoded string (RFC 4648 Section 5). The decoded string must result in the `content_language~feed_label~offer_id` structure. This encoding MUST be used if any part of the product identifier (like `offer_id`) contains characters such as `/`, `%`, or `~`. * Example: To represent the product ID `en~US~sku/123`, the `{productinput}` segment must be the unpadded base64url encoding of this string, which is `ZW5-VVN-c2t1LzEyMw`. The full resource name for the product would be `accounts/123/productInputs/ZW5-VVN-c2t1LzEyMw`. 2. **Plain Format**: The `{productinput}` segment is the tilde-separated string `content_language~feed_label~offer_id`. This format is suitable only when `content_language`, `feed_label`, and `offer_id` do not contain URL-problematic characters like `/`, `%`, or `~`. We recommend using the **Encoded Format** for all product IDs to ensure correct parsing, especially those containing special characters. The presence of tilde (`~`) characters in the `{productinput}` segment is used to differentiate between the two formats.",
 "type": "string"
 },
 "offerId": {
@@ -2085,6 +2437,11 @@ false
 "$ref": "Price",
 "description": "The amount the buyer has to pay per month."
 },
+"annualPercentageRate": {
+"description": "Optional. Annual percentage rate for `credit_type` finance",
+"format": "double",
+"type": "number"
+},
 "creditType": {
 "description": "Type of installment payments.",
 "enum": [
@@ -2107,6 +2464,45 @@ false
 "description": "The number of installments the buyer has to pay.",
 "format": "int64",
 "type": "string"
+},
+"totalAmount": {
+"$ref": "Price",
+"description": "Optional. Total amount the buyer has to pay, including interest."
+}
+},
+"type": "object"
+},
+"ProductMinimumOrderValue": {
+"description": "The minimum order value in the cart before the checkout is permitted.",
+"id": "ProductMinimumOrderValue",
+"properties": {
+"country": {
+"description": "Required. The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.",
+"type": "string"
+},
+"price": {
+"$ref": "Price",
+"description": "Required. The minimum cart or basket value before the checkout is permitted."
+},
+"service": {
+"description": "A free-form description of the service class or delivery speed. This should match the service value set for the Shipping attribute. See service.",
+"type": "string"
+},
+"surface": {
+"description": "The surface to which the minimum order value applies. Defaults to `ONLINE_LOCAL` if not configured.",
+"enum": [
+"SURFACE_UNSPECIFIED",
+"ONLINE",
+"LOCAL",
+"ONLINE_LOCAL"
+],
+"enumDescriptions": [
+"Surface is unspecified.",
+"Surface value to indicate online purchases.",
+"Surface value to indicate local purchases.",
+"Surface value to indicate online and local purchases."
+],
+"type": "string"
 }
 },
 "type": "object"
@@ -2282,6 +2678,14 @@ false
 "format": "int64",
 "type": "string"
 },
+"loyaltyProgramLabel": {
+"description": "Optional. The label of the [loyalty program](https://support.google.com/merchants/answer/6324484). Must match one of the program labels set in loyalty_programs. When set (in combination with [loyalty_tier_label](https://support.google.com/merchants/answer/6324484)), this shipping option is only applicable to loyalty program members of the specified tier.",
+"type": "string"
+},
+"loyaltyTierLabel": {
+"description": "Optional. The label of the [loyalty tier](https://support.google.com/merchants/answer/6324484) within the loyalty program. Must match one of the tiers set in the loyalty_programs. When set (in combination with [loyalty_program_label](https://support.google.com/merchants/answer/6324484)), this shipping option is only applicable to loyalty program members of the specified tier.",
+"type": "string"
+},
 "maxHandlingTime": {
 "description": "Maximum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it is received if it happens before the cut-off time. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds. minHandlingTime is optional if maxHandlingTime is present.",
 "format": "int64",
@@ -2481,6 +2885,22 @@ false
 }
 },
 "type": "object"
+},
+"Warranty": {
+"description": "The warranty of the vehicle.",
+"id": "Warranty",
+"properties": {
+"duration": {
+"description": "The warranty duration in months.",
+"format": "int64",
+"type": "string"
+},
+"mileage": {
+"$ref": "Mileage",
+"description": "The warranty mileage."
+}
+},
+"type": "object"
 }
 },
 "servicePath": "",