--- title: "Operate on item batch" method: POST path: "/catalogs/items/batch" tags: ["catalog_items"] --- # Operate on item batch `POST /catalogs/items/batch` This endpoint supports multiple operations on a set of one or more catalog items owned by the "operation user_account". [See detailed documentation here.](/docs/work-with-catalogs/modify-items-in-batch/) - By default, the "operation user_account" is the token user_account. Optional: Business Access: Specify an `ad_account_id` (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the "operation user_account". In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account: Owner, Admin, Catalogs Manager. Note: - Access to the Creative Assets catalog type is restricted to a specific group of users. If you require access, please reach out to your partner manager. - The item UPSERT operation is restricted to users without a feed data source. If you plan to migrate item ingestion from feeds to the API, please reach out to your partner manager or via the Help Center to get assistance. ## Query parameters - `ad_account_id` string ## Request body - union - union — A request object that can have multiple operations on a single batch - object — A request object that can have multiple operations on a single retail batch - `catalog_id` string - `catalog_type` 'RETAIL', required - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country ID from ISO 3166-1 alpha-2. - `items` CatalogsRetailBatchRequestItemsItems[], required — Array with catalogs item operations - union - object — An item to be created - `attributes` ItemAttributesRequest, required - … - `item_id` string, required — The catalog item id in the merchant namespace - `operation` 'CREATE', required - object — An item to be updated - `attributes` UpdatableItemAttributes, required - … - `item_id` string, required — The catalog item id in the merchant namespace - `operation` 'UPDATE', required - `update_mask` UpdateMaskFieldType[], nullable — The list of product attributes to be updated. Attributes specified in the update mask without a value specified in the body will be deleted from the product item. - object — An item to be upserted - `attributes` ItemAttributesRequest, required - … - `item_id` string, required — The catalog item id in the merchant namespace - `operation` 'UPSERT', required - object — An item to be deleted - `item_id` string, required — The catalog item id in the merchant namespace - `last_updated_time` integer — The millisecond timestamp when the item was lastly modified by the merchant. - `operation` 'DELETE', required - `language` union, required — We recommend using the CatalogsLocale values. - 'af-ZA' | 'ar-SA' | 'bg-BG' | 'bn-IN' | 'cs-CZ' | 'da-DK' | 'de' | 'el-GR' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-IN' | 'en-US' | 'es-419' | 'es-AR' | 'es-ES' | 'es-MX' | 'fi-FI' | 'fr' | 'fr-CA' | 'he-IL' | 'hi-IN' | 'hr-HR' | 'hu-HU' | 'id-ID' | 'it' | 'ja' | 'ko-KR' | 'ms-MY' | 'nb-NO' | 'nl' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sk-SK' | 'sv-SE' | 'te-IN' | 'th-TH' | 'tl-PH' | 'tr' | 'uk-UA' | 'vi-VN' | 'zh-CN' | 'zh-TW' - 'AM' | 'AR' | 'AZ' | 'BG' | 'BN' | 'BS' | 'CA' | 'CS' | 'DA' | 'DV' | 'DZ' | 'DE' | 'EL' | 'EN' | 'ES' | 'ET' | 'FA' | 'FI' | 'FR' | 'HE' | 'HI' | 'HR' | 'HU' | 'HY' | 'ID' | 'IN' | 'IS' | 'IT' | 'IW' | 'JA' | 'KA' | 'KM' | 'KO' | 'LO' | 'LT' | 'LV' | 'MK' | 'MN' | 'MS' | 'MY' | 'NB' | 'NE' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'RU' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'TL' | 'UK' | 'VI' | 'TE' | 'TH' | 'TR' | 'XX' | 'ZH' — Language code, which is among the official ISO 639-1 language list. - object — Request object to update catalogs hotel items - `catalog_id` string - `catalog_type` 'HOTEL', required - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country ID from ISO 3166-1 alpha-2. - `items` CatalogsHotelBatchItem[], required — Array with catalogs item operations - union — Hotel batch item - object — A hotel item to be created. - `attributes` CatalogsHotelAttributes, required - … - `hotel_id` string, required — The catalog hotel id in the merchant namespace - `operation` 'CREATE', required - object — A hotel item to be upserted. - `attributes` CatalogsHotelAttributes, required - … - `hotel_id` string, required — The catalog hotel id in the merchant namespace - `operation` 'UPSERT', required - object — Object describing an hotel item batch record - `attributes` CatalogsUpdatableHotelAttributes, required - … - `hotel_id` string, required — The catalog hotel item id in the merchant namespace - `operation` 'UPDATE', required - object — A hotel item to be deleted - `hotel_id` string, required — The catalog hotel id in the merchant namespace - `operation` 'DELETE', required - `language` union, required — We recommend using the CatalogsLocale values. - 'af-ZA' | 'ar-SA' | 'bg-BG' | 'bn-IN' | 'cs-CZ' | 'da-DK' | 'de' | 'el-GR' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-IN' | 'en-US' | 'es-419' | 'es-AR' | 'es-ES' | 'es-MX' | 'fi-FI' | 'fr' | 'fr-CA' | 'he-IL' | 'hi-IN' | 'hr-HR' | 'hu-HU' | 'id-ID' | 'it' | 'ja' | 'ko-KR' | 'ms-MY' | 'nb-NO' | 'nl' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sk-SK' | 'sv-SE' | 'te-IN' | 'th-TH' | 'tl-PH' | 'tr' | 'uk-UA' | 'vi-VN' | 'zh-CN' | 'zh-TW' - 'AM' | 'AR' | 'AZ' | 'BG' | 'BN' | 'BS' | 'CA' | 'CS' | 'DA' | 'DV' | 'DZ' | 'DE' | 'EL' | 'EN' | 'ES' | 'ET' | 'FA' | 'FI' | 'FR' | 'HE' | 'HI' | 'HR' | 'HU' | 'HY' | 'ID' | 'IN' | 'IS' | 'IT' | 'IW' | 'JA' | 'KA' | 'KM' | 'KO' | 'LO' | 'LT' | 'LV' | 'MK' | 'MN' | 'MS' | 'MY' | 'NB' | 'NE' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'RU' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'TL' | 'UK' | 'VI' | 'TE' | 'TH' | 'TR' | 'XX' | 'ZH' — Language code, which is among the official ISO 639-1 language list. - object — Request object to update catalogs creative assets items - `catalog_id` string - `catalog_type` 'CREATIVE_ASSETS', required - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country ID from ISO 3166-1 alpha-2. - `items` CatalogsCreativeAssetsBatchItem[], required — Array with creative assets item operations - union — Creative assets batch item - object — A creative assets item to be created. - `attributes` CatalogsCreativeAssetsAttributes, required - … - `creative_assets_id` string, required — The catalog creative assets id in the merchant namespace - `operation` 'CREATE', required - object — A creative assets item to be upserted. - `attributes` CatalogsCreativeAssetsAttributes, required - … - `creative_assets_id` string, required — The catalog creative assets id in the merchant namespace - `operation` 'UPSERT', required - object — A creative assets item to be updated. - `attributes` CatalogsUpdatableCreativeAssetsAttributes, required - … - `creative_assets_id` string, required — The catalog creative assets item id in the merchant namespace - `operation` 'UPDATE', required - object — A creative assets item to be deleted - `creative_assets_id` string, required — The catalog creative assets id in the merchant namespace - `operation` 'DELETE', required - `language` union, required — We recommend using the CatalogsLocale values. - 'af-ZA' | 'ar-SA' | 'bg-BG' | 'bn-IN' | 'cs-CZ' | 'da-DK' | 'de' | 'el-GR' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-IN' | 'en-US' | 'es-419' | 'es-AR' | 'es-ES' | 'es-MX' | 'fi-FI' | 'fr' | 'fr-CA' | 'he-IL' | 'hi-IN' | 'hr-HR' | 'hu-HU' | 'id-ID' | 'it' | 'ja' | 'ko-KR' | 'ms-MY' | 'nb-NO' | 'nl' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sk-SK' | 'sv-SE' | 'te-IN' | 'th-TH' | 'tl-PH' | 'tr' | 'uk-UA' | 'vi-VN' | 'zh-CN' | 'zh-TW' - 'AM' | 'AR' | 'AZ' | 'BG' | 'BN' | 'BS' | 'CA' | 'CS' | 'DA' | 'DV' | 'DZ' | 'DE' | 'EL' | 'EN' | 'ES' | 'ET' | 'FA' | 'FI' | 'FR' | 'HE' | 'HI' | 'HR' | 'HU' | 'HY' | 'ID' | 'IN' | 'IS' | 'IT' | 'IW' | 'JA' | 'KA' | 'KM' | 'KO' | 'LO' | 'LT' | 'LV' | 'MK' | 'MN' | 'MS' | 'MY' | 'NB' | 'NE' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'RU' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'TL' | 'UK' | 'VI' | 'TE' | 'TH' | 'TR' | 'XX' | 'ZH' — Language code, which is among the official ISO 639-1 language list. - union — Request object of catalogs items batch - object — Request object to update catalogs items - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country ID from ISO 3166-1 alpha-2. - `items` ItemUpdateBatchRecord[], required — Array with catalogs items - `attributes` UpdatableItemAttributes - `ad_image_0_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_0_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_10_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_10_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_11_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_11_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_12_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_12_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_13_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_13_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_14_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_14_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_15_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_15_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_16_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_16_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_17_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_17_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_18_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_18_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_19_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_19_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_1_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_1_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_2_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_2_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_3_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_3_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_4_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_4_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_5_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_5_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_6_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_6_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_7_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_7_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_8_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_8_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_9_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_9_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_link` string, nullable — Allows advertisers to specify a separate URL that can be used to track traffic coming from Pinterest shopping ads. Must send full URL including tracking. Must begin with http:// or https://. - `ad_video_0_link` string, nullable — Restricted. Ad video link that supplements main video for shopping campaigns. Video format:- Pixel size between 75 x 75 and 9450 x 9450 - File size smaller than 2 GB - Time span between 4 seconds and 15 minutes - Accepted formats: .MP4, .MOV, .M4V Link guidelines:- Include extension in file name - Do not include template or placeholder videos in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_video_0_tag` string, nullable — Restricted. Ad video tag. If you provide an ad_video_x_link, include the video tag with the corresponding ad_video_x_tag attribute. - `ad_video_1_link` string, nullable — Restricted. Ad video link that supplements main video for shopping campaigns. Video format:- Pixel size between 75 x 75 and 9450 x 9450 - File size smaller than 2 GB - Time span between 4 seconds and 15 minutes - Accepted formats: .MP4, .MOV, .M4V Link guidelines:- Include extension in file name - Do not include template or placeholder videos in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_video_1_tag` string, nullable — Restricted. Ad video tag. If you provide an ad_video_x_link, include the video tag with the corresponding ad_video_x_tag attribute. - `ad_video_2_link` string, nullable — Restricted. Ad video link that supplements main video for shopping campaigns. Video format:- Pixel size between 75 x 75 and 9450 x 9450 - File size smaller than 2 GB - Time span between 4 seconds and 15 minutes - Accepted formats: .MP4, .MOV, .M4V Link guidelines:- Include extension in file name - Do not include template or placeholder videos in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_video_2_tag` string, nullable — Restricted. Ad video tag. If you provide an ad_video_x_link, include the video tag with the corresponding ad_video_x_tag attribute. - `adult` boolean, nullable — Set this attribute to TRUE if you're submitting items that are considered "adult". These will not be shown on Pinterest. - `age_group` string, nullable — The age group to apply a demographic range to the product. Must be one of the following values (upper or lowercased): 'newborn', 'infant', 'toddler', 'kids', or 'adult'. - `android_deep_link` string — The deep link to the product on the Android app. - `availability` string — The availability of the product. Must be one of the following values (upper or lowercased): 'in stock', 'out of stock', 'preorder'. - `average_review_rating` number, nullable — Average reviews for the item. Can be a number from 1-5. - `brand` string, nullable — The brand of the product. - `checkout_enabled` boolean, nullable — This attribute is not supported anymore. - `color` string, nullable — The primary color of the product. - `condition` string, nullable — The condition of the product. Must be one of the following values (upper or lowercased): 'new', 'used', or 'refurbished'. - `custom_label_0` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_1` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_2` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_3` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_4` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_number_0` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_1` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_2` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_3` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_4` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `description` string — <= 10000 characters. The description of the product. - `free_shipping_label` boolean, nullable — The item is free to ship. - `free_shipping_limit` string, nullable — The minimum order purchase necessary for the customer to get free shipping. Only relevant if free shipping is offered. - `gender` string, nullable — The gender associated with the product. Must be one of the following values (upper or lowercased): 'male', 'female', or 'unisex'. - `google_product_category` string, nullable — The categorization of the product based on the standardized Google Product Taxonomy. This is a set taxonomy. Both the text values and numeric codes are accepted. - `gtin` union — The unique universal product identifier. - string, nullable - integer, nullable — DEPRECATED: Integer format will be removed in future versions. Please use string format to preserve leading zeros and maintain GTIN integrity. - `id` string — <= 127 characters. The user-created unique ID that represents the product. Only Unicode characters are accepted. - `installment_price` string, nullable — Installment price of the product. Expected format: : - `ios_deep_link` string — The deep link to the product on the iOS app. - `item_group_id` string, nullable — <= 127 characters. The parent ID of the product. - `last_updated_time` integer, nullable — The millisecond timestamp when the item was lastly modified by the merchant. - `link` string — <= 511 characters. The landing page for the product. - `material` string, nullable — The material used to make the product. - `min_ad_price` string, nullable — The minimum advertised price of the product. It supports the following formats: "19.99 USD", "19.99USD" and "19.99". If the currency is not included, we default to US dollars. - `mobile_link` string, nullable — The mobile-optimized version of your landing page. Must begin with http:// or https://. - `mpn` string, nullable — Manufacturer Part Number are alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer. - `number_of_ratings` integer, nullable — The number of ratings for the item. - `number_of_reviews` integer, nullable — The number of reviews available for the item. - `pattern` string, nullable — The description of the pattern used for the product. - `price` string — The price of the product. It supports the following formats: "24.99 USD", "24.99USD" and "24.99". If the currency is not included, we default to US dollars. - `product_type` string, nullable — <= 1000 characters. The categorization of your product based on your custom product taxonomy. Subcategories must be sent separated by " > ". - `promotion_id` string, nullable — A unique identifier referencing the promotion associated with this catalog item. - `sale_price` string, nullable — The discounted price of the product. The sale_price must be lower than the price. It supports the following formats: "14.99 USD", "14.99USD" and "14.99". - `sale_price_effective_date` string, nullable — Sale price effective date. Expected format: / (ISO 8601 format) - `shipping` string, nullable — Shipping consists of one group of up to four elements, country, region, service (all optional) and price (required). All colons, even for blank values, are required. - `shipping_height` string, nullable — The height of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. - `shipping_weight` string, nullable — The weight of the product. Ensure there is a space between the numeric string and the metric. - `shipping_width` string, nullable — The width of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. - `size` string, nullable — The size of the product. - `size_system` string, nullable — Indicates the country's sizing system in which you are submitting your product. Must be one of the following values (upper or lowercased): 'US', 'UK', 'EU', 'DE', 'FR', 'JP', 'CN', 'IT', 'BR', 'MEX', or 'AU'. - `size_type` string, nullable — Additional description for the size. Must be one of the following values (upper or lowercased): 'regular', 'petite', 'plus', 'big_and_tall', or 'maternity'. - `tax` string, nullable — Tax consists of one group of up to four elements, country, region, rate (all required) and tax_ship (optional). All colons, even for blank values, are required. - `title` string — <= 500 characters. The name of the product. - `unit_pricing_base_measure` string, nullable — Unit pricing base measure of the product. Expected format: - `unit_pricing_measure` string, nullable — Unit pricing total measure of the product. Expected format: - `variant_names` string[], nullable — Options for this variant. People will see these options next to your Pin and can select the one they want. List them in the order you want them displayed. - `variant_values` string[], nullable — Option values for this variant. People will see these options next to your Pin and can select the one they want. List them in the order you want them displayed. The order of the variant values must be consistent with the order of the variant names. - `item_id` string — The catalog item id in the merchant namespace - `update_mask` UpdateMaskFieldType[], nullable — The list of product attributes to be updated. Attributes specified in the update mask without a value specified in the body will be deleted from the product item. - `language` union, required — We recommend using the CatalogsLocale values. - 'af-ZA' | 'ar-SA' | 'bg-BG' | 'bn-IN' | 'cs-CZ' | 'da-DK' | 'de' | 'el-GR' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-IN' | 'en-US' | 'es-419' | 'es-AR' | 'es-ES' | 'es-MX' | 'fi-FI' | 'fr' | 'fr-CA' | 'he-IL' | 'hi-IN' | 'hr-HR' | 'hu-HU' | 'id-ID' | 'it' | 'ja' | 'ko-KR' | 'ms-MY' | 'nb-NO' | 'nl' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sk-SK' | 'sv-SE' | 'te-IN' | 'th-TH' | 'tl-PH' | 'tr' | 'uk-UA' | 'vi-VN' | 'zh-CN' | 'zh-TW' - 'AM' | 'AR' | 'AZ' | 'BG' | 'BN' | 'BS' | 'CA' | 'CS' | 'DA' | 'DV' | 'DZ' | 'DE' | 'EL' | 'EN' | 'ES' | 'ET' | 'FA' | 'FI' | 'FR' | 'HE' | 'HI' | 'HR' | 'HU' | 'HY' | 'ID' | 'IN' | 'IS' | 'IT' | 'IW' | 'JA' | 'KA' | 'KM' | 'KO' | 'LO' | 'LT' | 'LV' | 'MK' | 'MN' | 'MS' | 'MY' | 'NB' | 'NE' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'RU' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'TL' | 'UK' | 'VI' | 'TE' | 'TH' | 'TR' | 'XX' | 'ZH' — Language code, which is among the official ISO 639-1 language list. - `operation` 'UPDATE', required - object — Request object to upsert catalogs items - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country ID from ISO 3166-1 alpha-2. - `items` ItemUpsertBatchRecord[], required — Array with catalogs items - `attributes` ItemAttributesRequest - `ad_image_0_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_0_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_10_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_10_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_11_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_11_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_12_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_12_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_13_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_13_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_14_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_14_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_15_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_15_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_16_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_16_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_17_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_17_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_18_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_18_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_19_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_19_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_1_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_1_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_2_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_2_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_3_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_3_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_4_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_4_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_5_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_5_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_6_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_6_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_7_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_7_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_8_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_8_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_9_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_9_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_link` string, nullable — Allows advertisers to specify a separate URL that can be used to track traffic coming from Pinterest shopping ads. Must send full URL including tracking. Must begin with http:// or https://. - `ad_video_0_link` string, nullable — Restricted. Ad video link that supplements main video for shopping campaigns. Video format:- Pixel size between 75 x 75 and 9450 x 9450 - File size smaller than 2 GB - Time span between 4 seconds and 15 minutes - Accepted formats: .MP4, .MOV, .M4V Link guidelines:- Include extension in file name - Do not include template or placeholder videos in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_video_0_tag` string, nullable — Restricted. Ad video tag. If you provide an ad_video_x_link, include the video tag with the corresponding ad_video_x_tag attribute. - `ad_video_1_link` string, nullable — Restricted. Ad video link that supplements main video for shopping campaigns. Video format:- Pixel size between 75 x 75 and 9450 x 9450 - File size smaller than 2 GB - Time span between 4 seconds and 15 minutes - Accepted formats: .MP4, .MOV, .M4V Link guidelines:- Include extension in file name - Do not include template or placeholder videos in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_video_1_tag` string, nullable — Restricted. Ad video tag. If you provide an ad_video_x_link, include the video tag with the corresponding ad_video_x_tag attribute. - `ad_video_2_link` string, nullable — Restricted. Ad video link that supplements main video for shopping campaigns. Video format:- Pixel size between 75 x 75 and 9450 x 9450 - File size smaller than 2 GB - Time span between 4 seconds and 15 minutes - Accepted formats: .MP4, .MOV, .M4V Link guidelines:- Include extension in file name - Do not include template or placeholder videos in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_video_2_tag` string, nullable — Restricted. Ad video tag. If you provide an ad_video_x_link, include the video tag with the corresponding ad_video_x_tag attribute. - `additional_image_link` string[], nullable — <= 2000 characters The links to additional images for your product. Up to ten additional images can be used to show a product from different angles or to show different stages. Must begin with http:// or https://. - `adult` boolean, nullable — Set this attribute to TRUE if you're submitting items that are considered "adult". These will not be shown on Pinterest. - `age_group` string, nullable — The age group to apply a demographic range to the product. Must be one of the following values (upper or lowercased): 'newborn', 'infant', 'toddler', 'kids', or 'adult'. - `ai_disclosures` CatalogsAiContentDisclosure[] — AI content disclosures for individual assets (image_link, additional_image_link, or video_link) on this item. Each entry declares which disclosure types apply to a single asset URL. - `disclosure` CatalogsAiContentDisclosureLabel[], required — Disclosure labels that apply to this asset. - `url` string, required — URL of the asset. Must match one of image_link, additional_image_link, or video_link. - `android_deep_link` string — The deep link to the product on the Android app. - `availability` string — The availability of the product. Must be one of the following values (upper or lowercased): 'in stock', 'out of stock', 'preorder'. - `average_review_rating` number, nullable — Average reviews for the item. Can be a number from 1-5. - `brand` string, nullable — The brand of the product. - `checkout_enabled` boolean, nullable — This attribute is not supported anymore. - `color` string, nullable — The primary color of the product. - `condition` string, nullable — The condition of the product. Must be one of the following values (upper or lowercased): 'new', 'used', or 'refurbished'. - `custom_label_0` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_1` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_2` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_3` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_4` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_number_0` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_1` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_2` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_3` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_4` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `description` string — <= 10000 characters. The description of the product. - `free_shipping_label` boolean, nullable — The item is free to ship. - `free_shipping_limit` string, nullable — The minimum order purchase necessary for the customer to get free shipping. Only relevant if free shipping is offered. - `gender` string, nullable — The gender associated with the product. Must be one of the following values (upper or lowercased): 'male', 'female', or 'unisex'. - `google_product_category` string, nullable — The categorization of the product based on the standardized Google Product Taxonomy. This is a set taxonomy. Both the text values and numeric codes are accepted. - `gtin` union — The unique universal product identifier. - string, nullable - integer, nullable — DEPRECATED: Integer format will be removed in future versions. Please use string format to preserve leading zeros and maintain GTIN integrity. - `id` string — <= 127 characters. The user-created unique ID that represents the product. Only Unicode characters are accepted. - `image_link` union — <= 2000 characters The links to the main product images. Images should be at least 75x75 pixels to avoid errors. Use the additional_image_link field to add more images of your product. The URL of your image_link must be accessible by the Pinterest user-agent, and send the accurate images. Please make sure there are no template or placeholder images at the link. Must start with http:// or https://. - string - string[] — The main product image link. The list of links to the main product images. - `installment_price` string, nullable — Installment price of the product. Expected format: : - `ios_deep_link` string — The deep link to the product on the iOS app. - `item_group_id` string, nullable — <= 127 characters. The parent ID of the product. - `last_updated_time` integer, nullable — The millisecond timestamp when the item was lastly modified by the merchant. - `link` string — <= 511 characters. The landing page for the product. - `material` string, nullable — The material used to make the product. - `min_ad_price` string, nullable — The minimum advertised price of the product. It supports the following formats: "19.99 USD", "19.99USD" and "19.99". If the currency is not included, we default to US dollars. - `mobile_link` string, nullable — The mobile-optimized version of your landing page. Must begin with http:// or https://. - `mpn` string, nullable — Manufacturer Part Number are alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer. - `number_of_ratings` integer, nullable — The number of ratings for the item. - `number_of_reviews` integer, nullable — The number of reviews available for the item. - `pattern` string, nullable — The description of the pattern used for the product. - `price` string — The price of the product. It supports the following formats: "24.99 USD", "24.99USD" and "24.99". If the currency is not included, we default to US dollars. - `product_type` string, nullable — <= 1000 characters. The categorization of your product based on your custom product taxonomy. Subcategories must be sent separated by " > ". - `promotion_id` string, nullable — A unique identifier referencing the promotion associated with this catalog item. - `sale_price` string, nullable — The discounted price of the product. The sale_price must be lower than the price. It supports the following formats: "14.99 USD", "14.99USD" and "14.99". - `sale_price_effective_date` string, nullable — Sale price effective date. Expected format: / (ISO 8601 format) - `save_pin_disabled` boolean — By default, product pins created from a catalog are able to be saved by Pinners. If you want to disable the save pin feature, set this attribute to true. This feature is only available for allowlisted merchants. Please contact your account manager to enable this feature. - `shipping` string, nullable — Shipping consists of one group of up to four elements, country, region, service (all optional) and price (required). All colons, even for blank values, are required. - `shipping_height` string, nullable — The height of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. - `shipping_weight` string, nullable — The weight of the product. Ensure there is a space between the numeric string and the metric. - `shipping_width` string, nullable — The width of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. - `size` string, nullable — The size of the product. - `size_system` string, nullable — Indicates the country's sizing system in which you are submitting your product. Must be one of the following values (upper or lowercased): 'US', 'UK', 'EU', 'DE', 'FR', 'JP', 'CN', 'IT', 'BR', 'MEX', or 'AU'. - `size_type` string, nullable — Additional description for the size. Must be one of the following values (upper or lowercased): 'regular', 'petite', 'plus', 'big_and_tall', or 'maternity'. - `tax` string, nullable — Tax consists of one group of up to four elements, country, region, rate (all required) and tax_ship (optional). All colons, even for blank values, are required. - `title` string — <= 500 characters. The name of the product. - `unit_pricing_base_measure` string, nullable — Unit pricing base measure of the product. Expected format: - `unit_pricing_measure` string, nullable — Unit pricing total measure of the product. Expected format: - `variant_names` string[], nullable — Options for this variant. People will see these options next to your Pin and can select the one they want. List them in the order you want them displayed. - `variant_values` string[], nullable — Option values for this variant. People will see these options next to your Pin and can select the one they want. List them in the order you want them displayed. The order of the variant values must be consistent with the order of the variant names. - `video_link` string, nullable — <= 2,000 characters Hosted link to the product video. File types for linked videos must be .mp4, .mov or .m4v. File size cannot exceed 2GB. - `item_id` string — The catalog item id in the merchant namespace - `language` union, required — We recommend using the CatalogsLocale values. - 'af-ZA' | 'ar-SA' | 'bg-BG' | 'bn-IN' | 'cs-CZ' | 'da-DK' | 'de' | 'el-GR' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-IN' | 'en-US' | 'es-419' | 'es-AR' | 'es-ES' | 'es-MX' | 'fi-FI' | 'fr' | 'fr-CA' | 'he-IL' | 'hi-IN' | 'hr-HR' | 'hu-HU' | 'id-ID' | 'it' | 'ja' | 'ko-KR' | 'ms-MY' | 'nb-NO' | 'nl' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sk-SK' | 'sv-SE' | 'te-IN' | 'th-TH' | 'tl-PH' | 'tr' | 'uk-UA' | 'vi-VN' | 'zh-CN' | 'zh-TW' - 'AM' | 'AR' | 'AZ' | 'BG' | 'BN' | 'BS' | 'CA' | 'CS' | 'DA' | 'DV' | 'DZ' | 'DE' | 'EL' | 'EN' | 'ES' | 'ET' | 'FA' | 'FI' | 'FR' | 'HE' | 'HI' | 'HR' | 'HU' | 'HY' | 'ID' | 'IN' | 'IS' | 'IT' | 'IW' | 'JA' | 'KA' | 'KM' | 'KO' | 'LO' | 'LT' | 'LV' | 'MK' | 'MN' | 'MS' | 'MY' | 'NB' | 'NE' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'RU' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'TL' | 'UK' | 'VI' | 'TE' | 'TH' | 'TR' | 'XX' | 'ZH' — Language code, which is among the official ISO 639-1 language list. - `operation` 'UPSERT', required - object — Request object to create catalogs items - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country ID from ISO 3166-1 alpha-2. - `items` ItemCreateBatchRecord[], required — Array with catalogs items - `attributes` ItemAttributesRequest - `ad_image_0_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_0_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_10_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_10_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_11_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_11_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_12_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_12_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_13_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_13_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_14_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_14_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_15_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_15_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_16_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_16_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_17_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_17_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_18_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_18_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_19_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_19_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_1_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_1_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_2_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_2_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_3_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_3_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_4_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_4_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_5_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_5_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_6_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_6_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_7_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_7_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_8_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_8_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_image_9_link` string, nullable — Ad image link that supplements main image for shopping campaigns. Image format:- Pixel size at least 75 x 75 Link guidelines:- Include extension in file name - Do not include template or placeholder images in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_image_9_tag` string, nullable — Ad image tag. If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute. - `ad_link` string, nullable — Allows advertisers to specify a separate URL that can be used to track traffic coming from Pinterest shopping ads. Must send full URL including tracking. Must begin with http:// or https://. - `ad_video_0_link` string, nullable — Restricted. Ad video link that supplements main video for shopping campaigns. Video format:- Pixel size between 75 x 75 and 9450 x 9450 - File size smaller than 2 GB - Time span between 4 seconds and 15 minutes - Accepted formats: .MP4, .MOV, .M4V Link guidelines:- Include extension in file name - Do not include template or placeholder videos in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_video_0_tag` string, nullable — Restricted. Ad video tag. If you provide an ad_video_x_link, include the video tag with the corresponding ad_video_x_tag attribute. - `ad_video_1_link` string, nullable — Restricted. Ad video link that supplements main video for shopping campaigns. Video format:- Pixel size between 75 x 75 and 9450 x 9450 - File size smaller than 2 GB - Time span between 4 seconds and 15 minutes - Accepted formats: .MP4, .MOV, .M4V Link guidelines:- Include extension in file name - Do not include template or placeholder videos in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_video_1_tag` string, nullable — Restricted. Ad video tag. If you provide an ad_video_x_link, include the video tag with the corresponding ad_video_x_tag attribute. - `ad_video_2_link` string, nullable — Restricted. Ad video link that supplements main video for shopping campaigns. Video format:- Pixel size between 75 x 75 and 9450 x 9450 - File size smaller than 2 GB - Time span between 4 seconds and 15 minutes - Accepted formats: .MP4, .MOV, .M4V Link guidelines:- Include extension in file name - Do not include template or placeholder videos in link - Make URL accessible to Pinterest user-agent - Must start with http:// or https:// - `ad_video_2_tag` string, nullable — Restricted. Ad video tag. If you provide an ad_video_x_link, include the video tag with the corresponding ad_video_x_tag attribute. - `additional_image_link` string[], nullable — <= 2000 characters The links to additional images for your product. Up to ten additional images can be used to show a product from different angles or to show different stages. Must begin with http:// or https://. - `adult` boolean, nullable — Set this attribute to TRUE if you're submitting items that are considered "adult". These will not be shown on Pinterest. - `age_group` string, nullable — The age group to apply a demographic range to the product. Must be one of the following values (upper or lowercased): 'newborn', 'infant', 'toddler', 'kids', or 'adult'. - `ai_disclosures` CatalogsAiContentDisclosure[] — AI content disclosures for individual assets (image_link, additional_image_link, or video_link) on this item. Each entry declares which disclosure types apply to a single asset URL. - `disclosure` CatalogsAiContentDisclosureLabel[], required — Disclosure labels that apply to this asset. - `url` string, required — URL of the asset. Must match one of image_link, additional_image_link, or video_link. - `android_deep_link` string — The deep link to the product on the Android app. - `availability` string — The availability of the product. Must be one of the following values (upper or lowercased): 'in stock', 'out of stock', 'preorder'. - `average_review_rating` number, nullable — Average reviews for the item. Can be a number from 1-5. - `brand` string, nullable — The brand of the product. - `checkout_enabled` boolean, nullable — This attribute is not supported anymore. - `color` string, nullable — The primary color of the product. - `condition` string, nullable — The condition of the product. Must be one of the following values (upper or lowercased): 'new', 'used', or 'refurbished'. - `custom_label_0` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_1` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_2` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_3` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_label_4` string, nullable — <= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs. Custom grouping of products. - `custom_number_0` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_1` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_2` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_3` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `custom_number_4` integer, nullable — An attribute for any integer information ranging from 0 to 4,294,967,295, which can be used to group items. - `description` string — <= 10000 characters. The description of the product. - `free_shipping_label` boolean, nullable — The item is free to ship. - `free_shipping_limit` string, nullable — The minimum order purchase necessary for the customer to get free shipping. Only relevant if free shipping is offered. - `gender` string, nullable — The gender associated with the product. Must be one of the following values (upper or lowercased): 'male', 'female', or 'unisex'. - `google_product_category` string, nullable — The categorization of the product based on the standardized Google Product Taxonomy. This is a set taxonomy. Both the text values and numeric codes are accepted. - `gtin` union — The unique universal product identifier. - string, nullable - integer, nullable — DEPRECATED: Integer format will be removed in future versions. Please use string format to preserve leading zeros and maintain GTIN integrity. - `id` string — <= 127 characters. The user-created unique ID that represents the product. Only Unicode characters are accepted. - `image_link` union — <= 2000 characters The links to the main product images. Images should be at least 75x75 pixels to avoid errors. Use the additional_image_link field to add more images of your product. The URL of your image_link must be accessible by the Pinterest user-agent, and send the accurate images. Please make sure there are no template or placeholder images at the link. Must start with http:// or https://. - string - string[] — The main product image link. The list of links to the main product images. - `installment_price` string, nullable — Installment price of the product. Expected format: : - `ios_deep_link` string — The deep link to the product on the iOS app. - `item_group_id` string, nullable — <= 127 characters. The parent ID of the product. - `last_updated_time` integer, nullable — The millisecond timestamp when the item was lastly modified by the merchant. - `link` string — <= 511 characters. The landing page for the product. - `material` string, nullable — The material used to make the product. - `min_ad_price` string, nullable — The minimum advertised price of the product. It supports the following formats: "19.99 USD", "19.99USD" and "19.99". If the currency is not included, we default to US dollars. - `mobile_link` string, nullable — The mobile-optimized version of your landing page. Must begin with http:// or https://. - `mpn` string, nullable — Manufacturer Part Number are alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer. - `number_of_ratings` integer, nullable — The number of ratings for the item. - `number_of_reviews` integer, nullable — The number of reviews available for the item. - `pattern` string, nullable — The description of the pattern used for the product. - `price` string — The price of the product. It supports the following formats: "24.99 USD", "24.99USD" and "24.99". If the currency is not included, we default to US dollars. - `product_type` string, nullable — <= 1000 characters. The categorization of your product based on your custom product taxonomy. Subcategories must be sent separated by " > ". - `promotion_id` string, nullable — A unique identifier referencing the promotion associated with this catalog item. - `sale_price` string, nullable — The discounted price of the product. The sale_price must be lower than the price. It supports the following formats: "14.99 USD", "14.99USD" and "14.99". - `sale_price_effective_date` string, nullable — Sale price effective date. Expected format: / (ISO 8601 format) - `save_pin_disabled` boolean — By default, product pins created from a catalog are able to be saved by Pinners. If you want to disable the save pin feature, set this attribute to true. This feature is only available for allowlisted merchants. Please contact your account manager to enable this feature. - `shipping` string, nullable — Shipping consists of one group of up to four elements, country, region, service (all optional) and price (required). All colons, even for blank values, are required. - `shipping_height` string, nullable — The height of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. - `shipping_weight` string, nullable — The weight of the product. Ensure there is a space between the numeric string and the metric. - `shipping_width` string, nullable — The width of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. - `size` string, nullable — The size of the product. - `size_system` string, nullable — Indicates the country's sizing system in which you are submitting your product. Must be one of the following values (upper or lowercased): 'US', 'UK', 'EU', 'DE', 'FR', 'JP', 'CN', 'IT', 'BR', 'MEX', or 'AU'. - `size_type` string, nullable — Additional description for the size. Must be one of the following values (upper or lowercased): 'regular', 'petite', 'plus', 'big_and_tall', or 'maternity'. - `tax` string, nullable — Tax consists of one group of up to four elements, country, region, rate (all required) and tax_ship (optional). All colons, even for blank values, are required. - `title` string — <= 500 characters. The name of the product. - `unit_pricing_base_measure` string, nullable — Unit pricing base measure of the product. Expected format: - `unit_pricing_measure` string, nullable — Unit pricing total measure of the product. Expected format: - `variant_names` string[], nullable — Options for this variant. People will see these options next to your Pin and can select the one they want. List them in the order you want them displayed. - `variant_values` string[], nullable — Option values for this variant. People will see these options next to your Pin and can select the one they want. List them in the order you want them displayed. The order of the variant values must be consistent with the order of the variant names. - `video_link` string, nullable — <= 2,000 characters Hosted link to the product video. File types for linked videos must be .mp4, .mov or .m4v. File size cannot exceed 2GB. - `item_id` string — The catalog item id in the merchant namespace - `language` union, required — We recommend using the CatalogsLocale values. - 'af-ZA' | 'ar-SA' | 'bg-BG' | 'bn-IN' | 'cs-CZ' | 'da-DK' | 'de' | 'el-GR' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-IN' | 'en-US' | 'es-419' | 'es-AR' | 'es-ES' | 'es-MX' | 'fi-FI' | 'fr' | 'fr-CA' | 'he-IL' | 'hi-IN' | 'hr-HR' | 'hu-HU' | 'id-ID' | 'it' | 'ja' | 'ko-KR' | 'ms-MY' | 'nb-NO' | 'nl' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sk-SK' | 'sv-SE' | 'te-IN' | 'th-TH' | 'tl-PH' | 'tr' | 'uk-UA' | 'vi-VN' | 'zh-CN' | 'zh-TW' - 'AM' | 'AR' | 'AZ' | 'BG' | 'BN' | 'BS' | 'CA' | 'CS' | 'DA' | 'DV' | 'DZ' | 'DE' | 'EL' | 'EN' | 'ES' | 'ET' | 'FA' | 'FI' | 'FR' | 'HE' | 'HI' | 'HR' | 'HU' | 'HY' | 'ID' | 'IN' | 'IS' | 'IT' | 'IW' | 'JA' | 'KA' | 'KM' | 'KO' | 'LO' | 'LT' | 'LV' | 'MK' | 'MN' | 'MS' | 'MY' | 'NB' | 'NE' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'RU' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'TL' | 'UK' | 'VI' | 'TE' | 'TH' | 'TR' | 'XX' | 'ZH' — Language code, which is among the official ISO 639-1 language list. - `operation` 'CREATE', required - object — Request object to discontinue catalogs items - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country ID from ISO 3166-1 alpha-2. - `items` ItemDeleteDiscontinuedBatchRecord[], required — Array with catalogs items - `item_id` string — The catalog item id in the merchant namespace - `language` union, required — We recommend using the CatalogsLocale values. - 'af-ZA' | 'ar-SA' | 'bg-BG' | 'bn-IN' | 'cs-CZ' | 'da-DK' | 'de' | 'el-GR' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-IN' | 'en-US' | 'es-419' | 'es-AR' | 'es-ES' | 'es-MX' | 'fi-FI' | 'fr' | 'fr-CA' | 'he-IL' | 'hi-IN' | 'hr-HR' | 'hu-HU' | 'id-ID' | 'it' | 'ja' | 'ko-KR' | 'ms-MY' | 'nb-NO' | 'nl' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sk-SK' | 'sv-SE' | 'te-IN' | 'th-TH' | 'tl-PH' | 'tr' | 'uk-UA' | 'vi-VN' | 'zh-CN' | 'zh-TW' - 'AM' | 'AR' | 'AZ' | 'BG' | 'BN' | 'BS' | 'CA' | 'CS' | 'DA' | 'DV' | 'DZ' | 'DE' | 'EL' | 'EN' | 'ES' | 'ET' | 'FA' | 'FI' | 'FR' | 'HE' | 'HI' | 'HR' | 'HU' | 'HY' | 'ID' | 'IN' | 'IS' | 'IT' | 'IW' | 'JA' | 'KA' | 'KM' | 'KO' | 'LO' | 'LT' | 'LV' | 'MK' | 'MN' | 'MS' | 'MY' | 'NB' | 'NE' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'RU' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'TL' | 'UK' | 'VI' | 'TE' | 'TH' | 'TR' | 'XX' | 'ZH' — Language code, which is among the official ISO 639-1 language list. - `operation` 'DELETE_DISCONTINUED', required - object — Request object to delete catalogs items - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country ID from ISO 3166-1 alpha-2. - `items` ItemDeleteBatchRecord[], required — Array with catalogs items - `item_id` string — The catalog item id in the merchant namespace - `language` union, required — We recommend using the CatalogsLocale values. - 'af-ZA' | 'ar-SA' | 'bg-BG' | 'bn-IN' | 'cs-CZ' | 'da-DK' | 'de' | 'el-GR' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-IN' | 'en-US' | 'es-419' | 'es-AR' | 'es-ES' | 'es-MX' | 'fi-FI' | 'fr' | 'fr-CA' | 'he-IL' | 'hi-IN' | 'hr-HR' | 'hu-HU' | 'id-ID' | 'it' | 'ja' | 'ko-KR' | 'ms-MY' | 'nb-NO' | 'nl' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sk-SK' | 'sv-SE' | 'te-IN' | 'th-TH' | 'tl-PH' | 'tr' | 'uk-UA' | 'vi-VN' | 'zh-CN' | 'zh-TW' - 'AM' | 'AR' | 'AZ' | 'BG' | 'BN' | 'BS' | 'CA' | 'CS' | 'DA' | 'DV' | 'DZ' | 'DE' | 'EL' | 'EN' | 'ES' | 'ET' | 'FA' | 'FI' | 'FR' | 'HE' | 'HI' | 'HR' | 'HU' | 'HY' | 'ID' | 'IN' | 'IS' | 'IT' | 'IW' | 'JA' | 'KA' | 'KM' | 'KO' | 'LO' | 'LT' | 'LV' | 'MK' | 'MN' | 'MS' | 'MY' | 'NB' | 'NE' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'RU' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'TL' | 'UK' | 'VI' | 'TE' | 'TH' | 'TR' | 'XX' | 'ZH' — Language code, which is among the official ISO 639-1 language list. - `operation` 'DELETE', required ## Response `200` The request has succeeded. - union — Object describing the catalogs items batch - object — Object describing the catalogs retail items batch - `batch_id` string - `catalog_type` 'RETAIL', required - `completed_time` string, date-time, nullable — Date and time (UTC) of the batch completion: YYYY-MM-DD'T'hh:mm:ss - `created_time` string, date-time, nullable, required — Date and time (UTC) of the batch creation: YYYY-MM-DD'T'hh:mm:ss. If null, batch creation was skipped due to a recent duplicate ingestion. - `items` ItemProcessingRecord[] — Array with the catalogs items processing records part of the catalogs items batch - `errors` ItemValidationEvent[] — Array with the validation errors for the item processing record. A non empty errors list causes the item processing to fail. - `attribute` string — The attribute that the item validation event references - `code` integer — The event code that the item validation event references - `message` string — Title message describing the item validation event - `item_id` string — The catalog item id in the merchant namespace - `status` 'SUCCESS' | 'FAILURE' | 'PROCESSING' — The status of the item processing record - `warnings` ItemValidationEvent[] — Array with the validation warnings for the item processing record - `attribute` string — The attribute that the item validation event references - `code` integer — The event code that the item validation event references - `message` string — Title message describing the item validation event - `status` 'PROCESSING' | 'COMPLETED' | 'FAILED' — The status of the operation performed by the batch - object — Object describing the catalogs hotel items batch. If specified, you must provide all properties. - `batch_id` string - `catalog_type` 'HOTEL', required - `completed_time` string, date-time, nullable — Date and time (UTC) of the batch completion: YYYY-MM-DD'T'hh:mm:ss - `created_time` string, date-time — Date and time (UTC) of the batch creation: YYYY-MM-DD'T'hh:mm:ss - `items` HotelProcessingRecord[] — Array with the catalogs items processing records part of the catalogs items batch - `errors` ItemValidationEvent[] — Array with the validation errors for the item processing record. A non empty errors list causes the item processing to fail. - `attribute` string — The attribute that the item validation event references - `code` integer — The event code that the item validation event references - `message` string — Title message describing the item validation event - `hotel_id` string — The catalog hotel id in the merchant namespace - `status` 'SUCCESS' | 'FAILURE' | 'PROCESSING' — The status of the item processing record - `warnings` ItemValidationEvent[] — Array with the validation warnings for the item processing record - `attribute` string — The attribute that the item validation event references - `code` integer — The event code that the item validation event references - `message` string — Title message describing the item validation event - `status` 'PROCESSING' | 'COMPLETED' | 'FAILED' — The status of the operation performed by the batch - object — Object describing the catalogs creative assets items batch - `batch_id` string - `catalog_type` 'CREATIVE_ASSETS', required - `completed_time` string, date-time, nullable — Date and time (UTC) of the batch completion: YYYY-MM-DD'T'hh:mm:ss - `created_time` string, date-time — Date and time (UTC) of the batch creation: YYYY-MM-DD'T'hh:mm:ss - `items` CreativeAssetsProcessingRecord[] — Array with the catalogs items processing records part of the catalogs items batch - `creative_assets_id` string — The catalog creative assets id in the merchant namespace - `errors` ItemValidationEvent[] — Array with the validation errors for the item processing record. A non empty errors list causes the item processing to fail. - `attribute` string — The attribute that the item validation event references - `code` integer — The event code that the item validation event references - `message` string — Title message describing the item validation event - `status` 'SUCCESS' | 'FAILURE' | 'PROCESSING' — The status of the item processing record - `warnings` ItemValidationEvent[] — Array with the validation warnings for the item processing record - `attribute` string — The attribute that the item validation event references - `code` integer — The event code that the item validation event references - `message` string — Title message describing the item validation event - `status` 'PROCESSING' | 'COMPLETED' | 'FAILED' — The status of the operation performed by the batch ## Other responses - `400` — The request could not be understood by the server due to unexpected data. - `401` — Authentication is required and has either failed or not been provided. - `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource. - `404` — The requested resource could not be found on this server. - `429` — The user has sent too many requests in a given amount of time and is being rate limited. - `default` — An unexpected error response. --- [API](https://skmtc.net/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.net/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/b698c180678a/schema)