openapi: 3.0.3
info:
  version: 5.18.0
  title: Pinterest REST API
  description: Pinterest's REST API
  contact:
    name: Pinterest, Inc.
    url: https://developers.pinterest.com/
  license:
    name: MIT
    url: https://spdx.org/licenses/MIT
  termsOfService: https://developers.pinterest.com/terms/
servers:
- url: https://api.pinterest.com/v5
tags:
- name: ad_accounts
  description: |-
    View analytical information about advertising.


    Note: If the current operation_user_account (defined by the access token)
    has access to another user's Ad Accounts via
    <a href='/docs/getting-started/using-business-access/'>Pinterest Business Access</a>,
    you can modify your request to use the current operation_user_account's
    permissions to those Ad Accounts by including the ad_account_id in the path
    parameters for the request (e.g. .../?ad_account_id=12345&...).
- name: ad_groups
  description: View, create or update ad groups.
- name: ads
  description: View, create or update ads.
- name: advanced_auction
  description: View, create, or update advanced auction item bid options.
- name: audience_insights
  description: View audience insights.
- name: audience_sharing
  description: |-
    View, share, or revoke shared audiences.<br>
    Audience Sharing endpoints are not available to all apps,
    if you are interested in using them, reach out to us on our help center page.
    <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.
- name: audiences
  description: View, create, or update audiences.
- name: billing
  description: View, create, or update information related to billing.
- name: boards
  description: View, create, update, or delete information about boards.
- name: bulk
  description: Create, update, or download ads-related entities in bulk.
- name: campaigns
  description: View, create or update campaigns.
- name: catalog_feeds
  description: View and manage catalog feeds.
  x-display-name: feeds
- name: catalog_items
  description: View and manage catalog items directly without a feed.
  x-display-name: items
- name: catalog_product_groups
  description: View and manage catalog product groups using filters.
  x-display-name: product_groups
- name: catalog_regions
  description: View and manage catalog regions defined by sets of postal codes.
  x-display-name: regions
- name: catalog_reports
  description: View and manage reports about catalogs.
  x-display-name: reports
- name: catalogs
  description: Manage information about shopping product catalogs and items.
- name: conversion_events
  description: Submit conversion events via the Pinterest API.
- name: conversion_tags
  description: View, create, or update conversion tags.
- name: customer_lists
  description: View, create, or update customer lists.
- name: integrations
  description: View, create, or update commerce integrations.
- name: keywords
  description: View, create or update keywords.
- name: lead_ads
  description: View, create, or update lead ads.
- name: lead_forms
  description: View lead forms.
- name: leads_export
  description: Create and export leads information from lead ads.
- name: media
  description: Register and manage media uploads.
- name: msot_events
  description: Submit Measurement Source of Truth attributed conversion events via
    the Pinterest API.
- name: oauth
  description: Generate and refresh OAuth access tokens.
- name: order_lines
  description: View order lines.
- name: pins
  description: View, create, update, or delete information about Pins.
- name: product_group_promotions
  description: View, create, update, or delete information about promoted product
    groups.
- name: promotions
  description: View, create, update, or delete promotions.
- name: resources
  description: View metadata about available metrics and targeting options in the
    Pinterest API.
- name: search
  description: Search for Pins and boards owned by the current user.
- name: targeting_template
  description: View, create or update targeting templates.
- name: terms
  description: View related and suggested terms for ads targeting.
- name: terms_of_service
  description: View Advertising Terms Of Service.
- name: user_account
  description: View user accounts associated with a given access token.
x-tagGroups:
- name: Pin and Boards
  tags:
  - pins
  - boards
  - media
  - aggregated_comments
  - aggregated_pin_data
  - user_account
  - entity_history
- name: Campaign Management
  tags:
  - ad_accounts
  - campaigns
  - ad_groups
  - ads
  - product_group_promotions
  - bulk
  - labels
- name: Targeting
  tags:
  - audiences
  - customer_lists
  - keywords
  - targeting_template
  - audience_insights
  - audience_sharing
- name: Ad Formats
  tags:
  - lead_forms
  - lead_ads
  - leads_export
  - promotions
- name: Billing
  tags:
  - billing
  - order_lines
  - terms_of_service
- name: Business Access
  tags:
  - business_access_assets
  - business_access_invite
  - business_access_relationships
- name: Conversions
  tags:
  - conversion_events
  - conversion_tags
  - msot_events
- name: Others
  tags:
  - advanced_auction
  - integrations
  - oauth
  - resources
  - search
  - terms
- name: Shopping
  tags:
  - catalogs
  - catalog_feeds
  - catalog_product_groups
  - catalog_reports
  - catalog_items
  - catalog_regions
paths:
  /ad_accounts:
    get:
      summary: List ad accounts
      description: |-
        Get a list of the ad_accounts that the "operation user_account" has access to.
        - This includes ad_accounts they own and ad_accounts that are owned by others who have granted them <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>.
      tags:
      - ad_accounts
      operationId: ad_accounts/list
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_include_shared_accounts'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Ad accounts
                      items:
                        $ref: '#/components/schemas/AdAccount'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    post:
      summary: Create ad account
      description: |-
        Create a new ad account. Different ad accounts can support different currencies, payment methods, etc.
        An ad account is needed to create campaigns, ad groups, and ads; other accounts (your employees or partners) can be assigned business access and appropriate roles to access an ad account. <p/>
        You can set up up to 50 ad accounts per user. (The user must have a business account to create an ad account.) <p/>
        For more, see <a class="reference external" href="https://help.pinterest.com/en/business/article/create-an-advertiser-account">Create an advertiser account</a>.
      tags:
      - ad_accounts
      operationId: ad_accounts/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdAccountCreateRequest'
        description: Ad account to create.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdAccount'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
  /ad_accounts/{ad_account_id}:
    get:
      summary: Get ad account
      description: Get an ad account
      operationId: ad_accounts/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdAccount'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - ad_accounts
  /ad_accounts/{ad_account_id}/ad_groups:
    get:
      summary: List ad groups
      description: |-
        List ad groups based on provided campaign IDs or ad group IDs.(campaign_ids or ad_group_ids). <p/>
        <strong>Note:</strong><p/>
        Provide only campaign_id or ad_group_id. Do not provide both.
      operationId: ad_groups/list
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_campaign_ids'
      - $ref: '#/components/parameters/query_ad_group_ids'
      - $ref: '#/components/parameters/query_entity_statuses'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_translate_interests_to_names'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/AdGroupResponse'
          description: Success
        '400':
          description: Invalid ad account group parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account group parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_groups
    post:
      summary: Create ad groups
      description: "Create multiple new ad groups. All ads in a given ad group will\
        \ have the same budget, bid, run dates, targeting, and placement (search,\
        \ browse, other). For more information, <a href=\"https://help.pinterest.com/en/business/article/campaign-structure\"\
        \ target=\"_blank\"> click here</a>.\n<strong>Notes:</strong>\n- `bid_in_micro_currency`\
        \ and `budget_in_micro_currency` should be expressed in microcurrency amounts\
        \ based on the currency field set in the advertiser's profile.<p/>\n<p>Microcurrency\
        \ is used to track very small transactions, based on the currency set in the\
        \ advertiser\u2019s profile.</p>\n<p>A microcurrency unit is 10^(-6) of the\
        \ standard unit of currency selected in the advertiser\u2019s profile.</p>\n\
        \ <p><strong>Equivalency equations</strong>, using dollars as an example currency:</p>\n\
        <ul>\n  <li>$1 = 1,000,000 microdollars</li>\n  <li>1 microdollar = $0.000001\
        \ </li>\n</ul>\n<p><strong>To convert between currency and microcurrency</strong>,\
        \ using dollars as an example currency:</p>\n<ul>\n  <li>To convert dollars\
        \ to microdollars, mutiply dollars by 1,000,000</li>\n  <li>To convert microdollars\
        \ to dollars, divide microdollars by 1,000,000</li>\n</ul>\n- Ad groups belong\
        \ to ad campaigns. Some types of campaigns (e.g. budget optimization) have\
        \ limits on the number of ad groups they can hold. If you exceed those limits,\
        \ you will get an error message.\n- Certain organizations with <a href=\"\
        /docs/getting-started/using-beta-and-restricted-features/\" target=\"blank\"\
        \ target=\"blank\">closed beta</a> access can set `start_time` and `end_time`\
        \ at the ad group level for campaigns with Campaign Budget Optimization (CBO)\
        \ objectives: `TRAFFIC`, `AWARENESS`, `WEB_CONVERSIONS`, and `CATALOG_SALES`.\
        \ All other organizations can set these scheduling parameters for non-CBO\
        \ campaigns only.\n- If the parent ad campaign has start and end times set,\
        \ ad group start and end times must occur within the parent campaign schedule. "
      operationId: ad_groups/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/AdGroupCreateRequest'
              maxItems: 30
              minItems: 1
              type: array
        description: List of ad groups to create, size limit [1, 30].
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdGroupArrayResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - ad_groups
    patch:
      summary: Update ad groups
      description: Update multiple existing ad groups.
      operationId: ad_groups/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/AdGroupUpdateRequest'
              maxItems: 30
              minItems: 1
              type: array
        description: List of ad groups to update, size limit [1, 30].
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdGroupArrayResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - ad_groups
  /ad_accounts/{ad_account_id}/ad_groups/analytics:
    get:
      summary: Get ad group analytics
      description: |-
        Get analytics for the specified ad groups in the specified <code>ad_account_id</code>, filtered by the specified options.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
      operationId: ad_groups/analytics
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_ad_group_ids_required'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      - $ref: '#/components/parameters/aggregate_report_rows'
      - $ref: '#/components/parameters/query_reporting_timezone'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdGroupsAnalyticsResponse'
          description: Success
        '400':
          description: Invalid ad account group analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account group analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_groups
  /ad_accounts/{ad_account_id}/ad_groups/targeting_analytics:
    get:
      summary: Get targeting analytics for ad groups
      description: |-
        Get targeting analytics for one or more ad groups.
        For the requested ad group(s) and metrics, the response will include the requested metric information
        (e.g. SPEND_IN_DOLLAR) for the requested target type (e.g. "age_bucket") for applicable values (e.g. "45-49"). <p/>
        - The token's user_account must either be the Owner of the specified ad account, or have one
        of the necessary roles granted to them via
        <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
      operationId: ad_groups_targeting_analytics/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_ad_group_ids_required'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_ad_group_targeting_types'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      - $ref: '#/components/parameters/query_attribution_types'
      - $ref: '#/components/parameters/query_reporting_timezone'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetricsResponse'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_groups
  /ad_accounts/{ad_account_id}/ad_groups/audience_sizing:
    post:
      summary: Get audience sizing
      description: "Get potential audience size for an ad group with given targeting\
        \ criteria. \nPotential audience size estimates the number of people you may\
        \ be able to reach per month with your campaign. \nIt is based on historical\
        \ advertising data and the targeting criteria you select.\nIt does not guarantee\
        \ results or take into account factors such as bid, budget, schedule, seasonality\
        \ or product experiments."
      operationId: ad_groups/audience_sizing
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdGroupAudienceSizingRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdGroupAudienceSizingResponse'
          description: Success
        '400':
          description: Invalid ad group audience sizing parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad group audience sizing parameters.
        '403':
          description: No access to requested audience list or product group.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: You don't have access to the requested audience list or product
                  group.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - ad_groups
  /ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}:
    get:
      summary: Get ad group
      description: Get a specific ad group given the ad group ID.
      operationId: ad_groups/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_ad_group_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdGroupResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - ad_groups
  /ad_accounts/{ad_account_id}/ad_previews:
    post:
      summary: Create ad preview with pin or image
      description: |-
        Create an ad preview given an ad account ID and either an existing organic pin ID or the URL for an image to be used to create the Pin and the ad. <p/>
        If you are creating a preview from an existing Pin, that Pin must be promotable: that is, it must have a clickthrough link and meet other requirements. (See <a href="https://help.pinterest.com/en/business/article/promoted-pins-overview" target="_blank">Ads Overview</a>.) <p/>
        You can view the returned preview URL on a webpage or iframe for 7 days, after which the URL expires. Collection ads are not currently supported ad preview.

        Creating ad preview from catalog product group is currently in BETA and is not available to all users.
      tags:
      - ads
      operationId: ad_previews/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: Create ad preview with pin or image.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdPreviewRequest'
      responses:
        '200':
          description: Successful ad preview creation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdPreviewURLResponse'
        '400':
          description: Invalid Pin parameters response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidPinUrl:
                  value:
                    code: 1
                    message: Whoops! It looks like you entered an invalid URL. Try
                      creating a Pin again with a valid URL.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /ad_accounts/{ad_account_id}/ads:
    get:
      summary: List ads
      description: |-
        List ads that meet the filters provided:
          - Listed campaign ids or ad group ids or ad ids
          - Listed entity statuses <p/>
        If no filter is provided, all ads in the ad account are returned. <p/>
        <strong>Note:</strong><p/>
        Provide only campaign_id or ad_group_id or ad_id. Do not provide more than one type. <p/>
        Review status is provided for each ad; if review_status is REJECTED, the rejected_reasons field will contain additional information.
        For more, see <a href="https://policy.pinterest.com/en/advertising-guidelines">Pinterest advertising standards</a>.
      operationId: ads/list
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_campaign_ids'
      - $ref: '#/components/parameters/query_ad_group_ids'
      - $ref: '#/components/parameters/query_ad_ids'
      - $ref: '#/components/parameters/query_entity_statuses'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/AdResponse'
          description: Success
        '400':
          description: Invalid ad account ads parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ads
    post:
      description: Create multiple new ads. Request must contain ad_group_id, creative_type,
        and the source Pin pin_id.
      operationId: ads/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/AdCreateRequest'
              maxItems: 30
              minItems: 1
              type: array
        description: List of ads to create, size limit [1, 30].
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdArrayResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Create ads
      tags:
      - ads
    patch:
      description: Update multiple existing ads
      operationId: ads/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/AdUpdateRequest'
              maxItems: 30
              minItems: 1
              type: array
        description: List of ads to update, size limit [1, 30]
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdArrayResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Update ads
      tags:
      - ads
  /ad_accounts/{ad_account_id}/ads/analytics:
    get:
      summary: Get ad analytics
      description: |-
        Get analytics for the specified ads in the specified <code>ad_account_id</code>, filtered by the specified options.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - The request must contain either ad_ids or both campaign_ids and pin_ids.
        - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
      operationId: ads/analytics
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_ad_ids'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      - name: pin_ids
        description: List of Pin IDs.
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
            pattern: ^\d+$
          minItems: 1
          maxItems: 100
      - $ref: '#/components/parameters/query_campaign_ids'
      - $ref: '#/components/parameters/query_reporting_timezone'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdsAnalyticsResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ads
  /ad_accounts/{ad_account_id}/ads_credit/discounts:
    get:
      summary: Get ads credit discounts
      description: |-
        Returns the list of discounts applied to the account.

        <strong>This endpoint might not be available to all apps. <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>
      operationId: ads_credits_discounts/get
      security:
      - pinterest_oauth2:
        - ads:read
        - billing:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      tags:
      - billing
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/AdsCreditDiscountsResponse'
          description: Success
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /ad_accounts/{ad_account_id}/ads_credit/redeem:
    post:
      summary: Redeem ad credits
      description: |-
        Redeem ads credit on behalf of the ad account id and apply it towards billing.

        <strong>This endpoint might not be available to all apps. <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>
      tags:
      - billing
      operationId: ads_credit/redeem
      security:
      - pinterest_oauth2:
        - ads:write
        - billing:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: Redeem ad credits request.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdsCreditRedeemRequest'
      responses:
        '200':
          description: Successfully redeemed ad credits.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdsCreditRedeemResponse'
        '400':
          description: Error thrown when unable to redeem offer code.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ValidationError:
                  value:
                    code: 15
                    message: Unable to redeem offer code. Try again later.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /ad_accounts/{ad_account_id}/ads/targeting_analytics:
    get:
      summary: Get targeting analytics for ads
      description: |-
        Get targeting analytics for one or more ads. For the requested ad(s) and metrics,
        the response will include the requested metric information (e.g. SPEND_IN_DOLLAR) for the requested target type
        (e.g. "age_bucket") for applicable values (e.g. "45-49"). <p/>
        - The token's user_account must either be the Owner of the specified ad account, or have one
        of the necessary roles granted to them via
        <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
      operationId: ad_targeting_analytics/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_ad_ids_required'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_ad_targeting_types'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      - $ref: '#/components/parameters/query_attribution_types'
      - $ref: '#/components/parameters/query_reporting_timezone'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetricsResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - ads
  /ad_accounts/{ad_account_id}/ads/{ad_id}:
    get:
      summary: Get ad
      description: |-
        Get a specific ad given the ad ID. If your pin is rejected, rejected_reasons will
        contain additional information from the Ad Review process.
        For more information about our policies and rejection reasons see the <a href="https://www.pinterest.com/_/_/policy/advertising-guidelines/" target="_blank">Pinterest advertising standards</a>.
      operationId: ads/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_ad_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - ads
  /ad_accounts/{ad_account_id}/analytics:
    get:
      summary: Get ad account analytics
      description: |-
        Get analytics for the specified <code>ad_account_id</code>, filtered by the specified options.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time.
      operationId: ad_account/analytics
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      - $ref: '#/components/parameters/query_reporting_timezone'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdAccountAnalyticsResponse'
          description: Success
        '400':
          description: Invalid ad account analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
  /ad_accounts/{ad_account_id}/audience_insights:
    get:
      summary: Get audience insights
      description: |-
        Get Audience Insights for an ad account. The response will return insights for 3 types of audiences: the
        ad account's engaged audience on Pinterest, the ad account's total audience on Pinterest and Pinterest's
        total audience.<p/>
        <a href="https://help.pinterest.com/en/business/article/audience-insights" target="_blank">Learn more about Audience Insights</a>.
      operationId: audience_insights/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_audience_insight_type'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceInsightsResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - audience_insights
  /ad_accounts/{ad_account_id}/audiences:
    get:
      summary: List audiences
      description: Get list of audiences for the ad account.
      operationId: audiences/list
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_bookmark'
      - description: "The order in which to sort the items returned: \u201CASCENDING\u201D\
          \ or \u201CDESCENDING\u201D by ID.\nFor received audiences, it is sorted\
          \ by sharing event time.\nNote that higher-value IDs are associated with\
          \ more-recently added items."
        in: query
        name: order
        required: false
        schema:
          type: string
          example: ASCENDING
          enum:
          - ASCENDING
          - DESCENDING
      - $ref: '#/components/parameters/query_page_size'
      - description: Filter audiences by ownership type.
        in: query
        name: ownership_type
        required: false
        example: OWNED
        schema:
          type: string
          default: OWNED
          enum:
          - OWNED
          - RECEIVED
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Audience'
          description: Success
        '400':
          description: Invalid ad account audience parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account audience parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audiences
    post:
      description: |-
        Create an audience you can use in targeting for specific ad groups. Targeting combines customer information with
        the ways users interact with Pinterest to help you reach specific groups of users; you can include or exclude
        specific audience_ids when you create an ad group. <p/>
        For more, see <a class="reference external" href="https://help.pinterest.com/en/business/article/audience-targeting" target="_blank">Audience targeting</a>.
      operationId: audiences/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceCreateRequest'
        description: List of ads to create, size limit [1, 30]
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Audience'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Create audience
      tags:
      - audiences
  /ad_accounts/{ad_account_id}/audiences/{audience_id}:
    get:
      summary: Get audience
      description: Get a specific audience given the audience ID.
      operationId: audiences/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_audience_id'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Audience'
        '404':
          description: Audience not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audiences
    patch:
      summary: Update audience
      description: Update (edit or remove) an existing targeting audience.
      operationId: audiences/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_audience_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceUpdateRequest'
        description: The audience to be updated.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Audience'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - audiences
  /ad_accounts/{ad_account_id}/audiences/custom:
    post:
      summary: Create custom audience
      description: Create a custom audience and find the audiences you want your ads
        to reach.
      operationId: audiences/create_custom
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: Custom audience to create.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceCreateCustomRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Audience'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audiences
  /ad_accounts/{ad_account_id}/audiences/shared/accounts:
    get:
      summary: List accounts with access to an audience owned by an ad account
      description: List all ad accounts and/or businesses that have access to a specific
        audience. The audience must be owned by the requesting ad account.
      operationId: ad_accounts_audiences_shared_accounts/list
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_audience_id'
      - $ref: '#/components/parameters/query_account_type'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/SharedAudienceAccount'
        '400':
          description: Invalid ad account audiences shared accounts parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account audiences shared accounts parameters.
        '404':
          description: Shared accounts not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audience_sharing
  /ad_accounts/{ad_account_id}/audiences/ad_accounts/shared:
    patch:
      summary: Update audience sharing between ad accounts
      description: From an ad account, share a specific audience with another ad account,
        or revoke access to a previously shared audience. Only the audience owner
        account can share the audience. The recipient ad account(s) must be in the
        same <a href='https://help.pinterest.com/en/business/article/create-and-manage-accounts'>Pinterest
        Business Hierarchy</a> as the business owner of the ad account.<br> This endpoint
        is not available to all apps.<a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn
        more</a>.
      operationId: update_ad_account_to_ad_account_shared_audience
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SharedAudience'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedAudienceResponse'
          description: Success
        '400':
          description: Invalid ad account id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audience_sharing
  /ad_accounts/{ad_account_id}/audiences/businesses/shared:
    patch:
      summary: Update audience sharing from an ad account to businesses
      description: From an ad account, share a specific audience with a business account,
        or revoke access to a previously shared audience. Only the audience owner
        account can share the audience. The recipient business account must be in
        the same business hierarchy as the business owner of the ad account.<br> This
        endpoint is not available to all apps.<a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn
        more</a>.
      operationId: update_ad_account_to_business_shared_audience
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BusinessSharedAudience'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessSharedAudienceResponse'
          description: Success
        '400':
          description: Invalid ad account id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audience_sharing
  /ad_accounts/{ad_account_id}/bid_floor:
    post:
      description: "List bid floors for your campaign configuration. Bid floors are\
        \ given in microcurrency values based on the currency in the bid floor specification.\
        \ <p/>\n<p>Microcurrency is used to track very small transactions, based on\
        \ the currency set in the advertiser\u2019s profile.</p>\n<p>A microcurrency\
        \ unit is 10^(-6) of the standard unit of currency selected in the advertiser\u2019\
        \ s profile.</p>\n<p><strong>Equivalency equations</strong>, using dollars\
        \ as an example currency:</p>\n<ul>\n  <li>$1 = 1,000,000 microdollars</li>\n\
        \  <li>1 microdollar = $0.000001 </li>\n</ul>\n<p><strong>To convert between\
        \ currency and microcurrency</strong>, using dollars as an example currency:</p>\n\
        <ul>\n  <li>To convert dollars to microdollars, mutiply dollars by 1,000,000</li>\n\
        \  <li>To convert microdollars to dollars, divide microdollars by 1,000,000</li>\n\
        \ </ul>\nFor more on bid floors see <a class=\"reference external\" href=\"\
        https://help.pinterest.com/en/business/article/set-your-bid\"> Set your bid</a>."
      operationId: ad_groups_bid_floor/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BidFloorRequest'
        description: Parameters to get bid_floor info
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BidFloor'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Get bid floors
      tags:
      - ad_groups
  /ad_accounts/{ad_account_id}/billing_profiles:
    get:
      summary: Get billing profiles
      description: |-
        Get billing profiles in the advertiser account.

        <strong>This endpoint might not be available to all apps. <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>
      operationId: billing_profiles/get
      security:
      - pinterest_oauth2:
        - ads:read
        - billing:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      tags:
      - billing
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - description: Return active billing profiles, if false return all billing profiles.
        in: query
        name: is_active
        required: true
        schema:
          type: boolean
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/BillingProfilesResponse'
          description: Success
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /ad_accounts/{ad_account_id}/billing_invoices:
    get:
      summary: Get billing invoices
      description: Get billing invoices in the advertiser account.
      operationId: billing_invoices/get
      security:
      - pinterest_oauth2:
        - ads:read
        - billing:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_sort_billing_invoice'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_billing_invoice_status'
      - $ref: '#/components/parameters/query_billing_document_type'
      - $ref: '#/components/parameters/query_billing_start_due_date'
      - $ref: '#/components/parameters/query_billing_end_due_date'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/BillingInvoiceResponse'
        '400':
          description: Invalid request parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid request parameter.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - billing
  /ad_accounts/{ad_account_id}/billing_invoice/{billing_invoice_id}/download:
    get:
      summary: Get download url for a billing invoice
      description: Get download url for a billing invoice.
      operationId: billing_invoice_download/get
      security:
      - pinterest_oauth2:
        - ads:read
        - billing:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_billing_invoice_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingInvoiceDownloadResponse'
          description: Successfully fetched Billing invoice information for a given
            ad account
        '400':
          description: Invalid request parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid request parameter.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - billing
  /ad_accounts/{ad_account_id}/bulk/download:
    post:
      summary: Get advertiser entities in bulk
      description: |-
        Create an asynchronous report that may include information on campaigns, ad groups, product groups, ads,
        keywords, and/or labels; can filter by campaigns. Though the entities may be active, archived, or paused,
        only active entities will return data.
      operationId: bulk_download/create
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkDownloadRequest'
        description: Parameters to get ad entities in bulk
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkDownloadResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - bulk
  /ad_accounts/{ad_account_id}/bulk/upsert:
    post:
      description: |-
        Either create or update any combination of campaigns, ad groups, product groups, ads, keywords, or labels.
        Note that this request will be processed asynchronously; the response will include a <code>request_id</code>
        that can be used to obtain the status of the request.
      operationId: bulk_upsert/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkUpsertRequest'
        description: Parameters to get create/update ad entities in bulk
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkUpsertResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Create/update ad entities in bulk
      tags:
      - bulk
  /ad_accounts/{ad_account_id}/bulk/{bulk_request_id}:
    get:
      description: |-
        Get the status of a bulk request by <code>request_id</code>, along with a download URL that will allow you to download the
        new or updated entity data (campaigns, ad groups, product groups, ads, or keywords).
      operationId: bulk_request/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_bulk_request_id'
      - $ref: '#/components/parameters/include_details'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkUpsertStatusResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Download advertiser entities in bulk
      tags:
      - bulk
  /ad_accounts/{ad_account_id}/campaigns:
    get:
      summary: List campaigns
      description: |-
        Get a list of the campaigns in the specified <code>ad_account_id</code>, filtered by the specified options.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
      operationId: campaigns/list
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_campaign_ids'
      - $ref: '#/components/parameters/query_entity_statuses'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/CampaignResponse'
          description: Success
        '400':
          description: Invalid ad account campaign parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account campaign parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - campaigns
    post:
      summary: Create campaigns
      description: "Create multiple new campaigns. Every campaign has its own campaign_id\
        \ and houses one or more ad groups, which contain one or more ads.\nFor more,\
        \ see <a href=\"https://help.pinterest.com/en/business/article/set-up-your-campaign/\"\
        >Set up your campaign</a>. <p/>\n<strong>Note:</strong>\n- The values for\
        \ 'lifetime_spend_cap' and 'daily_spend_cap' are microcurrency amounts based\
        \ on the currency field set in the advertiser's profile. (e.g. USD) <p/>\n\
        <p>Microcurrency is used to track very small transactions, based on the currency\
        \ set in the advertiser\u2019s profile.</p>\n<p>A microcurrency unit is 10^(-6)\
        \ of the standard unit of currency selected in the advertiser\u2019s profile.</p>\n\
        \ <p><strong>Equivalency equations</strong>, using dollars as an example currency:</p>\n\
        <ul>\n  <li>$1 = 1,000,000 microdollars</li>\n  <li>1 microdollar = $0.000001\
        \ </li>\n</ul>\n<p><strong>To convert between currency and microcurrency</strong>,\
        \ using dollars as an example currency:</p>\n<ul>\n  <li>To convert dollars\
        \ to microdollars, mutiply dollars by 1,000,000</li>\n  <li>To convert microdollars\
        \ to dollars, divide microdollars by 1,000,000</li>\n</ul>"
      tags:
      - campaigns
      operationId: campaigns/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: Array of campaigns.
        required: true
        content:
          application/json:
            schema:
              type: array
              maxItems: 30
              minItems: 1
              items:
                $ref: '#/components/schemas/CampaignCreateRequest'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignCreateResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    patch:
      summary: Update campaigns
      description: "Update multiple ad campaigns based on campaign_ids. <p/>\n<strong>Note:</strong><p/>\n\
        \ - <p>The values for 'lifetime_spend_cap' and 'daily_spend_cap' are microcurrency\
        \ amounts based on the currency field set in the advertiser's profile. (e.g.\
        \ USD) <p/>\n<p>Microcurrency is used to track very small transactions, based\
        \ on the currency set in the advertiser\u2019s profile.</p>\n<p>A microcurrency\
        \ unit is 10^(-6) of the standard unit of currency selected in the advertiser\u2019\
        \ s profile.</p>\n<p><strong>Equivalency equations</strong>, using dollars\
        \ as an example currency:</p>\n<ul>\n  <li>$1 = 1,000,000 microdollars</li>\n\
        \  <li>1 microdollar = $0.000001 </li>\n</ul>\n<p><strong>To convert between\
        \ currency and microcurrency</strong>, using dollars as an example currency:</p>\n\
        <ul>\n  <li>To convert dollars to microdollars, mutiply dollars by 1,000,000</li>\n\
        \  <li>To convert microdollars to dollars, divide microdollars by 1,000,000</li>\n\
        </ul>"
      tags:
      - campaigns
      operationId: campaigns/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: Array of campaigns.
        required: true
        content:
          application/json:
            schema:
              type: array
              maxItems: 30
              minItems: 1
              items:
                $ref: '#/components/schemas/CampaignUpdateRequest'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignUpdateResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /ad_accounts/{ad_account_id}/campaigns/analytics:
    get:
      summary: Get campaign analytics
      description: |-
        Get analytics for the specified campaigns in the specified <code>ad_account_id</code>, filtered by the specified options.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
      operationId: campaigns/analytics
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_campaign_ids_required'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      - $ref: '#/components/parameters/aggregate_report_rows'
      - $ref: '#/components/parameters/query_reporting_timezone'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignsAnalyticsResponse'
          description: Success
        '400':
          description: Invalid ad account campaign analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account campaign analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - campaigns
  /ad_accounts/{ad_account_id}/campaigns/targeting_analytics:
    get:
      summary: Get targeting analytics for campaigns
      description: |-
        Get targeting analytics for one or more campaigns.
        For the requested account and metrics, the response will include the requested metric information
        (e.g. SPEND_IN_DOLLAR) for the requested target type (e.g. "age_bucket") for applicable values (e.g. "45-49"). <p/>
        - The token's user_account must either be the Owner of the specified ad account, or have one
        of the necessary roles granted to them via
        <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
      operationId: campaign_targeting_analytics/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_campaign_ids_required'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_campaign_targeting_types'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      - $ref: '#/components/parameters/query_attribution_types'
      - $ref: '#/components/parameters/query_reporting_timezone'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetricsResponse'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - campaigns
  /ad_accounts/{ad_account_id}/campaigns/{campaign_id}:
    get:
      summary: Get campaign
      description: Get a specific campaign given the campaign ID.
      operationId: campaigns/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_campaign_id'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - campaigns
  /ad_accounts/{ad_account_id}/conversion_tags:
    get:
      summary: Get conversion tags
      description: List conversion tags associated with an ad account.
      operationId: conversion_tags/list
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_filter_deleted'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionTagListResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - conversion_tags
      x-sandbox: disabled
    post:
      x-sandbox: disabled
      summary: Create conversion tag
      description: "Create a conversion tag, also known as <a href=\"https://help.pinterest.com/en/business/article/set-up-the-pinterest-tag\"\
        \ target=\"_blank\">Pinterest tag</a>, with the option to enable enhanced\
        \ match.<p/>\nThe Pinterest Tag tracks actions people take on the ad account\u2019\
        \ s website after they view the ad account's ad on Pinterest. The advertiser\
        \ needs to customize this tag to track conversions.<p/>\nFor more information,\
        \ see:<p/>\n<a class=\"reference external\" href=\"https://help.pinterest.com/en/business/article/set-up-the-pinterest-tag\"\
        >Set up the Pinterest tag</a><p/>\n<a class=\"reference external\" href=\"\
        /docs/api-features/pinterest-tag/\">Pinterest Tag</a><p/>\n<a class=\"reference\
        \ external\" href=\"/docs/api-features/pinterest-tag/#enhanced-match\">Enhanced\
        \ match</a>"
      operationId: conversion_tags/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConversionTagCreate'
        description: Conversion Tag to create
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionTagResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - conversion_tags
  /ad_accounts/{ad_account_id}/conversion_tags/ocpm_eligible:
    get:
      summary: Get Ocpm eligible conversion tags
      description: Get Ocpm eligible conversion tag events for an ad account.
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      operationId: ocpm_eligible_conversion_tags/get
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      x-sandbox: disabled
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionTagsOcpmEligibleResponse'
        default:
          description: Unexpected errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - conversion_tags
  /ad_accounts/{ad_account_id}/conversion_tags/page_visit:
    get:
      summary: Get page visit conversion tags
      description: Get all page visit conversion tag events for an ad account.
      operationId: page_visit_conversion_tags/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/ConversionEventResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - conversion_tags
  /ad_accounts/{ad_account_id}/conversion_tags/{conversion_tag_id}:
    get:
      x-sandbox: disabled
      summary: Get conversion tag
      description: Get information about an existing conversion tag.
      operationId: conversion_tags/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_conversion_tag_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionTagResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - conversion_tags
  /ad_accounts/{ad_account_id}/customer_lists:
    post:
      description: "<p>Create a customer list from your records(hashed or plain-text\
        \ email addresses, or hashed MAIDs or IDFAs).</p>\n<p>A customer list is one\
        \ of the four types of Pinterest audiences: for more information, see <a href=\"\
        https://help.pinterest.com/en/business/article/audience-targeting\" target=\"\
        _blank\">Audience targeting</a>\nor the <a href=\"/docs/api-features/targeting-overview/\"\
        \ target=\"_blank\">Audiences</a> section of the ads management guide.<p/>\n\
        \ <p><b>Please review our <u><a href=\"https://help.pinterest.com/en/business/article/audience-targeting#section-13341\"\
        \ target=\"_blank\">requirements</a></u> for what type of information is allowed\
        \ when uploading a customer list.</b></p>\n<p>When you create a customer list,\
        \ the system scans the list for existing Pinterest accounts;\nthe list must\
        \ include at least 100 Pinterest accounts. Your original list will be deleted\
        \ when the matching process\nis complete. The filtered list \u2013 containing\
        \ only the Pinterest accounts that were included in your starting\nlist \u2013\
        \ is what will be used to create the audience.</p>\n<p>Note that once you\
        \ have created your customer list, you must convert it into an audience (of\
        \ the \u201C CUSTOMER_LIST\u201D type)\nusing the <a href=\"#operation/create_audience_handler\"\
        >create audience endpoint</a> before it can be used.</p>"
      operationId: customer_lists/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustomerListRequest'
        description: Parameters to get Customer lists info
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerList'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Create customer lists
      tags:
      - customer_lists
    get:
      description: |-
        <p>Get a set of customer lists including id and name based on the filters provided.</p>
        <p>(Customer lists are a type of audience.) For more information, see
        <a href="https://help.pinterest.com/en/business/article/audience-targeting" target="_blank">Audience targeting</a>
         or the <a href="/docs/api-features/targeting-overview/" target="_blank">Audiences</a>
        section of the ads management guide.</p>
      operationId: customer_lists/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/CustomerList'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Get customer lists
      tags:
      - customer_lists
  /ad_accounts/{ad_account_id}/customer_lists/{customer_list_id}:
    get:
      summary: Get customer list
      description: Gets a specific customer list given the customer list ID.
      operationId: customer_lists/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_customer_list_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerList'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - customer_lists
    patch:
      description: "<p>Append or remove records to/from an existing customer list.\
        \ (A customer list is one of the four types of Pinterest audiences.)</p>\n\
        <p>When you add records to an existing customer list, the system scans the\
        \ additions for existing Pinterest\naccounts; those are the records that will\
        \ be added to your \u201CCUSTOMER_LIST\u201D audience. Your original list\
        \ of records\n to add will be deleted when the matching process is complete.</p>\n\
        <p>For more information, see <a href=\"https://help.pinterest.com/en/business/article/audience-targeting\"\
        \ target=\"_blank\">Audience targeting</a>\nor the <a href=\"/docs/api-features/targeting-overview/\"\
        \ target=\"_blank\">Audiences</a>\nsection of the ads management guide.</p>"
      operationId: customer_lists/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_customer_list_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustomerListUpdateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerList'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Update customer list
      tags:
      - customer_lists
  /ad_accounts/{ad_account_id}/events:
    post:
      summary: Send conversions
      description: |-
        The Pinterest API offers advertisers a way to send Pinterest their conversion information (including web conversions, in-app conversions, or even offline conversions) based on their <code>ad_account_id</code>. The request body should be a JSON object.
        - This endpoint requires an <code>access_token</code> be generated through Ads Manager. Review the <a href="/docs/api-features/conversion-overview/">Conversions Guide</a> for more details. (Note that the authorization header required is <code>Authorization: Bearer &lt;access_token&gt;</code>).
        - The token's <code>user_account</code> must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Audience, Campaign. (Note that the token can be used across multiple ad accounts under an user ID.)
        - This endpoint has a rate limit of 5,000 calls per minute per ad account.
        - If the merchant is submitting this information using both Pinterest conversion tags and the Pinterest API, Pinterest will remove duplicate information before reporting. (Note that events that took place offline cannot be deduplicated.)
      operationId: events/create
      tags:
      - conversion_events
      security:
      - pinterest_oauth2:
        - ads:write
      - conversion_token: []
      x-ratelimit-category: ads_conversions
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - name: test
        description: |-
          Include query param ?test=true to mark the request as a test request. The events will not be recorded but the API will still return the same response messages. Use this mode to verify your requests are working and your events are constructed correctly.
          Warning: If you use this query parameter, be certain that it is off (set to false or deleted) before sending a legitimate (non-testing) request.
        in: query
        required: false
        schema:
          type: boolean
      requestBody:
        description: Conversion events.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConversionEvents'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionApiResponse'
          description: Success
        '400':
          description: The request was invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 4196
                message: The request was invalid.
        '401':
          description: Not authorized to send conversion events
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 2
                    message: Authentication failed.
        '403':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DetailedError'
          description: Not all events were successfully processed.
        '429':
          description: |-
            This request exceeded a rate limit. This can happen if the client exceeds one
            of the published rate limits within a short time window.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 8
                message: |-
                  This request exceeded a rate limit. This can happen if the client exceeds one
                  of the published rate limits within a short time window.
        '503':
          description: The endpoint has been ramped down and is currently not accepting
            any traffic.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 4197
                message: The endpoint has been ramped down and is currently not accepting
                  any traffic.
        default:
          description: Unexpected errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /ad_accounts/{ad_account_id}/msot/events:
    post:
      summary: Send Measurement Source Of Truth (MSOT) attributed conversion events
      description: |-
        <strong>This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.</strong>
        <br>
        <p>Advertisers or their measurement partners can send attributed MSOT conversion events to Pinterest based on their <code>ad_account_id</code>. The request body should be a JSON object.</p>
        - These events will NOT be used in Reporting.
      operationId: msot_events/create
      security:
      - pinterest_oauth2:
        - msot:write
      x-ratelimit-category: msot_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: Attributed MSOT conversion events
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConversionMSOTEvents'
      responses:
        '200':
          description: Success
        '400':
          description: The request was invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 4196
                message: The request was invalid
        '401':
          description: Not authorized to send MSOT conversion events
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 3
                message: Your token does not have sufficient permissions to perform
                  this operation. Please ensure your token is authorized with the
                  correct set of scopes.
        '403':
          description: Unauthorized access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 29
                message: You are not permitted to access the resource
        '429':
          description: |-
            This request exceeded a rate limit. This can happen if the client exceeds one
            of the published rate limits within a short time window.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 8
                message: |-
                  This request exceeded a rate limit. This can happen if the client exceeds one
                  of the published rate limits within a short time window.
        default:
          description: Unexpected errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - msot_events
  /ad_accounts/{ad_account_id}/insights/audiences:
    get:
      summary: Get audience insights scope and type
      description: Get the scope and type of available audiences, which along with
        a date, is an audience that has recently had an interaction (referred to here
        as a type) on pins. Interacted pins can belong to at least the most common
        **partner** or **Pinterest** scopes. This means that user interactions made
        on advertiser or partner pins will have the **partner** scope. You can also
        have user interactions performed in general on Pinterest with the **Pinterest**
        scope. In that case, you can then use the returned type and scope values together
        on requests to other endpoints to retrieve insight metrics for a desired audience.
      operationId: audience_insights_scope_and_type/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceDefinitionResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - audience_insights
  /ad_accounts/{ad_account_id}/keywords:
    get:
      summary: Get keywords
      description: |-
        <p>Get a list of keywords based on the filters provided. If no filter is provided, it will default to the ad_account_id filter, which means it will only return keywords that specifically have parent_id set to the ad_account_id. Note: Keywords can have ad_account_ids, campaign_ids, and ad_group_ids set as their parent_ids. Keywords created through Ads Manager will have their parent_id set to an ad_group_id, not ad_account_id.</p>
        <p>For more information, see <a target="_blank" href="https://help.pinterest.com/en/business/article/keyword-targeting">Keyword targeting</a>.</p>
        <p><b>Notes:</b></p> <ul style="list-style-type: square;"> <li>Advertisers and campaigns can only be assigned keywords with excluding ('_NEGATIVE').</li> <li>All keyword match types are available for ad groups.</li> </ul> <p>For more information on match types, see <a target="_blank" href="/docs/api-features/targeting-overview/">match type enums</a>.</p>
        <p><b>Returns:</b></p> <ul style="list-style-type: square;"> <li><p>A successful call returns an object containing an array of new keyword objects and an empty &quot;errors&quot; object array.</p></li> <li><p>An unsuccessful call returns an empty keywords array, and, instead, inserts the entire object with nulled/negated properties into the &quot;errors&quot; object array:</p> <pre class="last literal-block"> { "keywords": [], "errors": [ { "data": { "archived": null, "match_type": "EXACT", "parent_type": null, "value": "foobar", "parent_id": null, "type": "keyword", "id": null }, "error_messages": [ "Advertisers and Campaigns only accept excluded targeting attributes." ] } } </pre></li> </ul>
      operationId: keywords/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_campaign_id'
      - $ref: '#/components/parameters/query_ad_group_id'
      - $ref: '#/components/parameters/query_match_types'
      - name: page_size
        description: Maximum number of items to include in a single page of the response.
          Default maximum of 250. See documentation on <a href='/docs/reference/pagination/'>Pagination</a>
          for more information.
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          default: 25
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Keyword'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - keywords
    post:
      summary: Create keywords
      description: |-
        <p>Create keywords for following entity types(advertiser, campaign, ad group or ad).</p> <p>For more information, see <a target="_blank" href="https://help.pinterest.com/en/business/article/keyword-targeting">Keyword targeting</a>.</p>
        <p><b>Notes:</b></p> <ul style="list-style-type: square;"> <li>Advertisers and campaigns can only be assigned keywords with excluding ('_NEGATIVE').</li> <li>All keyword match types are available for ad groups.</li> </ul> <p>For more information on match types, see <a  target="_blank" href="/docs/api-features/targeting-overview/">match type enums</a>.</p>
        <p><b>Returns:</b></p> <ul style="list-style-type: square;"> <li><p>A successful call returns an object containing an array of new keyword objects and an empty &quot;errors&quot; object array.</p></li> <li><p>An unsuccessful call returns an empty keywords array, and, instead, inserts the entire object with nulled/negated properties into the &quot;errors&quot; object array:</p> <pre class="last literal-block"> { "keywords": [], "errors": [ { "data": { "archived": null, "match_type": "EXACT", "parent_type": null, "value": "foobar", "parent_id": null, "type": "keyword", "id": null }, "error_messages": [ "Advertisers and Campaigns only accept excluded targeting attributes." ] } } </pre></li> </ul>
        <p><b>Rate limit</b>: <a href="/docs/reference/rate-limits/">WRITE</a>.</p>
      operationId: keywords/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KeywordsRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KeywordsResponse'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - keywords
    patch:
      summary: Update keywords
      description: <p>Update one or more keywords' bid and archived fields.</p> <p>Archiving
        a keyword effectively deletes it - keywords no longer receive metrics and
        no longer visible within the parent entity's keywords list.</p>
      operationId: keywords/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KeywordUpdateBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KeywordsResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - keywords
  /ad_accounts/{ad_account_id}/keywords/metrics:
    get:
      summary: Get country's keyword metrics
      description: |-
        See keyword metrics for a specified country, aggregated across all of Pinterest.
        (Definitions are available from the "Get delivery metrics definitions"
        <a href="/docs/api/v5/#operation/delivery_metrics/get">API endpoint</a>).
      operationId: country_keywords_metrics/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_country_code'
      - $ref: '#/components/parameters/query_keywords'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KeywordsMetricsArrayResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - keywords
  /ad_accounts/{ad_account_id}/labels:
    post:
      summary: Create labels
      description: |-
        <p>
        <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Closed beta</a>
        This endpoint is not available to all users.
        </p>
        <p>
          Apply one or more labels to a campaign.
          Currently, you can apply brand and custom labels. Future releases will provide more options.

          <b>Note:</b> You can only apply one brand label to a campaign. You can apply 30 custom labels to a campaign.
         </p>
      operationId: labels/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LabelCreateRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LabelsResponse'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - labels
    get:
      summary: List labels
      description: |-
        <p>
          <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Closed beta</a>
          This endpoint is not available to all users.
        </p>
        <p>
          See a list of labels for assets that your account owns, and filter the list by different criteria.
        </p>
      operationId: labels/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_campaign_ids'
      - $ref: '#/components/parameters/query_label_ids'
      - $ref: '#/components/parameters/query_label_entity_statuses'
      - $ref: '#/components/parameters/query_label_types'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/LabelsResponse'
          description: Success
        '400':
          description: Invalid ad account ads parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - labels
    patch:
      summary: Update labels
      description: |-
        <p>
          <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Closed beta</a>
          This endpoint is not available to all users.
        </p>
        <p>
          Change the properties of one or more labels.
        </p>
      operationId: labels/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LabelUpdateRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LabelsResponse'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - labels
  /ad_accounts/{ad_account_id}/lead_forms:
    get:
      summary: List lead forms
      description: |-
        <strong>This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.</strong>

        List lead forms associated with an ad account ID.

        For more, see <a class="reference external" href="https://help.pinterest.com/en/business/article/lead-ads">Lead ads</a>.
      operationId: lead_forms/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/LeadFormResponse'
          description: Success
        '400':
          description: Invalid ad account lead forms parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account lead forms parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - lead_forms
    post:
      x-sandbox: disabled
      description: "<strong>This feature is currently in beta and not available to\
        \ all apps, if you're interested in joining the beta, please reach out to\
        \ your Pinterest account manager.</strong>\n\nCreate lead forms. Lead forms\
        \ are used in lead ads and allow you to control what text appears on the lead\
        \ form\u2019 s description, questions and confirmation sections.\n\nFor more,\
        \ see <a class=\"reference external\" href=\"https://help.pinterest.com/en/business/article/lead-ads\"\
        >Lead ads</a>."
      summary: Create lead forms
      operationId: lead_forms/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/LeadFormCreateRequest'
              maxItems: 30
              minItems: 1
              type: array
        description: List of lead forms to create, size limit [1, 30].
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadFormArrayResponse'
          description: Success
        '400':
          description: Invalid ad account lead forms parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account lead forms parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - lead_forms
    patch:
      x-sandbox: disabled
      description: |-
        <strong>This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.</strong>

        Update lead forms. Lead ads help you reach people who are actively looking for, and interested in, your goods and services. The lead form can be associated with an ad to allow people to fill out the form.

        For more, see <a class="reference external" href="https://help.pinterest.com/en/business/article/lead-ads">Lead ads</a>.
      summary: Update lead forms
      operationId: lead_forms/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/LeadFormUpdateRequest'
              maxItems: 30
              minItems: 1
              type: array
        description: List of lead forms to update, size limit [1, 30].
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadFormArrayResponse'
          description: Success
        '400':
          description: Invalid ad account lead forms parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account lead forms parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - lead_forms
  /ad_accounts/{ad_account_id}/lead_forms/{lead_form_id}:
    get:
      summary: Get lead form by id
      description: |-
        <strong>This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.</strong>

        Gets a lead form given it's ID. It must also be associated with the provided ad account ID.

        For more, see <a class="reference external" href="https://help.pinterest.com/en/business/article/lead-ads">Lead ads</a>.
      operationId: lead_form/get
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_lead_form_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadFormResponse'
          description: Success
        '400':
          description: Invalid ad account lead forms parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 1
                message: Invalid ad account lead forms parameters.
        '404':
          description: The lead form ID for the given ad account ID does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 4842
                message: Lead form is not found.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - lead_forms
  /ad_accounts/{ad_account_id}/lead_forms/{lead_form_id}/test:
    post:
      summary: Create lead form test data
      description: |-
        Create lead form test data based on the list of answers provided as part of the body.
        - List of answers should follow the questions creation order.
      operationId: lead_form_test/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_lead_form_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LeadFormTestRequest'
        description: Subscription to create.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadFormTestResponse'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 1
                message: Invalid parameters.
        '404':
          description: Lead not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 4842
                message: Lead not found.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - lead_forms
  /ad_accounts/{ad_account_id}/leads/subscriptions:
    get:
      operationId: ad_accounts_subscriptions/get_list
      summary: Get lead ads subscriptions
      description: Get the advertiser's list of lead ads subscriptions. Only requests
        for the OWNER or ADMIN of the ad_account will be allowed.
      parameters:
      - $ref: '#/components/parameters/Pinterest.Lib.AdAccountId'
      - $ref: '#/components/parameters/Pinterest.Lib.BookmarkParams.bookmark'
      - $ref: '#/components/parameters/Pinterest.Lib.BookmarkParams.page_size'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: object
                required:
                - items
                properties:
                  bookmark:
                    type: string
                    nullable: true
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/LeadSubscription'
        '400':
          description: The request could not be understood by the server due to unexpected
            data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '401':
          description: Authentication is required and has either failed or not been
            provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '403':
          description: The request was valid, but the server is refusing action. The
            user might not have the necessary permissions for a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '404':
          description: The requested resource could not be found on this server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '429':
          description: The user has sent too many requests in a given amount of time
            and is being rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
      tags:
      - lead_ads
      security:
      - pinterest_oauth2:
        - ads:read
      x-sandbox: disabled
      x-ratelimit-category: ads_read
    post:
      operationId: ad_accounts_subscriptions/post
      summary: Create lead ads subscription
      description: |-
        Create a lead ads webhook subscription.
        Subscriptions allow Pinterest to deliver lead data from Ads Manager directly to the subscriber. Subscriptions can exist for a specific lead form or at ad account level.
          - Only requests for the OWNER or ADMIN of the ad_account will be allowed.
          - Advertisers can set up multiple integrations using ad_account_id + lead_form_id but only one integration per unique records.
          - For data security, egress lead data is encrypted with AES-256-GCM.
      parameters:
      - $ref: '#/components/parameters/Pinterest.Lib.AdAccountId'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadSubscription'
        '400':
          description: The request could not be understood by the server due to unexpected
            data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '403':
          description: The request was valid, but the server is refusing action. The
            user might not have the necessary permissions for a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
      tags:
      - lead_ads
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LeadSubscriptionPostParamsCreate'
      security:
      - pinterest_oauth2:
        - ads:write
      x-sandbox: enabled
      x-ratelimit-category: ads_write
  /ad_accounts/{ad_account_id}/leads/subscriptions/{subscription_id}:
    get:
      operationId: ad_accounts_subscriptions/get_by_id
      summary: Get lead ads subscription by ID
      description: |-
        Get an existing lead ads webhook subscription by ID.
          - Only requests for the OWNER or ADMIN of the ad_account will be allowed.'
      parameters:
      - $ref: '#/components/parameters/Pinterest.Lib.AdAccountId'
      - $ref: '#/components/parameters/SubscriptionIdPathParam'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadSubscription'
        '400':
          description: The request could not be understood by the server due to unexpected
            data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '401':
          description: Authentication is required and has either failed or not been
            provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '403':
          description: The request was valid, but the server is refusing action. The
            user might not have the necessary permissions for a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '404':
          description: The requested resource could not be found on this server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '429':
          description: The user has sent too many requests in a given amount of time
            and is being rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
      tags:
      - lead_ads
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-sandbox: disabled
      x-ratelimit-category: ads_read
    delete:
      operationId: ad_accounts_subscriptions/del_by_id
      summary: Delete lead ads subscription
      description: |-
        Delete an existing lead ads webhook subscription by ID.
          - Only requests for the OWNER or ADMIN of the ad_account will be allowed.'
      parameters:
      - $ref: '#/components/parameters/Pinterest.Lib.AdAccountId'
      - $ref: '#/components/parameters/SubscriptionIdPathParam'
      responses:
        '204':
          description: Resource deleted successfully.
        '400':
          description: The request could not be understood by the server due to unexpected
            data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '401':
          description: Authentication is required and has either failed or not been
            provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '403':
          description: The request was valid, but the server is refusing action. The
            user might not have the necessary permissions for a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '404':
          description: The requested resource could not be found on this server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '429':
          description: The user has sent too many requests in a given amount of time
            and is being rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
      tags:
      - lead_ads
      security:
      - pinterest_oauth2:
        - ads:write
      x-sandbox: disabled
      x-ratelimit-category: ads_write
  /ad_accounts/{ad_account_id}/leads_export:
    post:
      x-sandbox: disabled
      description: |-
        <strong>This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.</strong>

        Create an export of leads collected from a lead ad. This returns a lead_export_id  token that you can use to download the export when it is ready.

        Note: Lead ad data will be available up to 30 days after the lead has been submitted.

        For more, see <a class="reference external" href="https://help.pinterest.com/en/business/article/lead-ads">Lead ads</a>.
      summary: Create a request to export leads collected from a lead ad
      operationId: leads_export/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LeadsExportCreateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadsExportCreateResponse'
          description: Success
        '400':
          description: Invalid ad account parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account parameter.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - leads_export
  /ad_accounts/{ad_account_id}/leads_export/{leads_export_id}:
    get:
      x-sandbox: disabled
      description: |-
        <strong>This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.</strong>

        Get the export of leads collected from a lead ad. This returns a URL to a list of lead export given a lead_export_id token returned from the create a lead export call. You can use the URL to download the report.

        Note: Lead ad data will be available up to 30 days after the lead has been submitted.

        For more, see <a class="reference external" href="https://help.pinterest.com/en/business/article/lead-ads">Lead ads</a>.
      summary: Get the lead export from the lead export create call
      operationId: leads_export/get
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - name: leads_export_id
        in: path
        description: lead_export_id token returned from the create a lead export endpoint
        example: '123755885175'
        required: true
        schema:
          type: string
          pattern: ^\d+$
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadsExportResponseData'
          description: Success
        '400':
          description: Invalid ad account parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account parameter.
        '404':
          description: Invalid leads export id parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: Invalid leads export id parameter.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - leads_export
  /ad_accounts/{ad_account_id}/mmm_reports:
    get:
      summary: Get advertiser Marketing Mix Modeling (MMM) report.
      description: |-
        Get an mmm report for an ad account. This returns a URL to an mmm metrics report given a token returned from the
        create mmm report endpoint.
      operationId: analytics/get_mmm_report
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_token_required'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMMMReportResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
    post:
      summary: Create a request for a Marketing Mix Modeling (MMM) report
      description: |-
        This creates an asynchronous mmm report based on the given request. It returns a token that you can use to download
        the report when it is ready. NOTE: An additional limit of 5 queries per minute per advertiser applies to this endpoint while it's in beta release.
      operationId: analytics/create_mmm_report
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateMMMReportRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateMMMReportResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics mmm parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads analytics mmm parameters
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
  /ad_accounts/{ad_account_id}/order_lines:
    get:
      summary: Get order lines
      description: List existing order lines associated with an ad account.
      operationId: order_lines/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/OrderLine'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - order_lines
  /ad_accounts/{ad_account_id}/order_lines/{order_line_id}:
    get:
      summary: Get order line
      description: Get a specific existing order line associated with an ad account.
      operationId: order_lines/get
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_order_line_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderLine'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - order_lines
  /ad_accounts/{ad_account_id}/pins/analytics:
    get:
      summary: Get pins analytics
      description: |-
        Get analytics for the pins given a campaign and pins in the specified <code>ad_account_id</code>, filtered by the specified options.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - If granularity is not HOUR, the furthest back you can are allowed to pull data is 90 days before the current date in UTC time and the max time range supported is 90 days.
        - If granularity is HOUR, the furthest back you can are allowed to pull data is 8 days before the current date in UTC time and the max time range supported is 3 days. Data will not be provided for conversion metrics but will be available for non-conversion metrics.
      operationId: ad_pins/analytics
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_campaign_id_required'
      - $ref: '#/components/parameters/query_required_pin_ids'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdPinsAnalyticsResponse'
          description: Success
        '400':
          description: Invalid ad account pins analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account pins analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - campaigns
  /ad_accounts/{ad_account_id}/product_group_promotions:
    post:
      description: Add one or more product groups from your catalog to an existing
        ad group. (Product groups added to an ad group are a 'product group promotion.')
      operationId: product_group_promotions/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductGroupPromotionCreateRequest'
        description: List of Product Group Promotions to create, size limit [1, 30].
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductGroupPromotionResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Create product group promotions
      tags:
      - product_group_promotions
    patch:
      description: Update multiple existing Product Group Promotions (by product_group_id)
      operationId: product_group_promotions/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductGroupPromotionUpdateRequest'
        description: Parameters to update Product group promotions
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductGroupPromotionResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Update product group promotions
      tags:
      - product_group_promotions
    get:
      description: |-
        List existing product group promotions associated with an ad account.

        Include either ad_group_id or product_group_promotion_ids in your request.

        <b>Note:</b> ad_group_ids and product_group_promotion_ids are mutually exclusive parameters.
        Only provide one. If multiple options are provided, product_group_promotion_ids takes precedence over ad_group_ids. If none are provided, the endpoint returns an error.
      operationId: product_group_promotions/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_product_group_promotion_ids'
      - $ref: '#/components/parameters/query_entity_statuses'
      - $ref: '#/components/parameters/query_ad_group_id'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/ProductGroupPromotion'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Get product group promotions
      tags:
      - product_group_promotions
  /ad_accounts/{ad_account_id}/product_group_promotions/{product_group_promotion_id}:
    get:
      description: Get a product group promotion by id
      operationId: product_group_promotions/get
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_product_group_promotion_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductGroupPromotion'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Get a product group promotion by id
      tags:
      - product_group_promotions
  /ad_accounts/{ad_account_id}/product_groups/analytics:
    get:
      summary: Get product group analytics
      description: |-
        Get analytics for the specified product groups in the specified <code>ad_account_id</code>, filtered by the specified options.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
          - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
      operationId: product_groups/analytics
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_product_group_ids_required'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      - $ref: '#/components/parameters/query_reporting_timezone'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductGroupAnalyticsResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - product_group_promotions
  /ad_accounts/{ad_account_id}/promotions:
    get:
      summary: Get promotions
      description: Gets all promotions associated with an ad account ID that can be
        applied to an ad group. Can be either internally-saved promotions or external
        promotions imported from a commerce integration.
      operationId: promotions/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/PromotionResponse'
        '400':
          description: Invalid ad account promotions parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account promotions parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - promotions
    post:
      description: Create multiple new promotions.
      operationId: promotions/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              description: List of promotions to create.
              items:
                $ref: '#/components/schemas/PromotionCreateRequest'
              maxItems: 30
              minItems: 1
        description: List of promotions to create, size limit [1, 30].
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromotionsResponse'
          description: Success
        '400':
          description: Invalid create promotions request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Platform type not supported for promotions.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Create promotions
      tags:
      - promotions
    patch:
      description: Update multiple promotions.
      operationId: promotions/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              description: List of promotion data updates keyed on promotion id.
              items:
                $ref: '#/components/schemas/PromotionUpdateRequest'
              maxItems: 30
              minItems: 1
        description: List of promotions to create, size limit [1, 30].
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromotionsResponse'
          description: Success
        '400':
          description: Invalid create promotions request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Platform type not supported for promotions.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Update promotions
      tags:
      - promotions
  /ad_accounts/{ad_account_id}/promotions/{promotion_id}:
    get:
      summary: Get promotion by id
      description: Get a promotion by its Pinterest-specific id. It must be associated
        with the provided ad account id.
      operationId: promotions/get
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_promotion_id'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromotionResponse'
        '404':
          description: The promotion ID for the given ad account ID was not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 4997
                message: Promotion for that ID was not found
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - promotions
    delete:
      summary: Delete promotion by id
      description: Delete a promotion within Pinterest.
      operationId: promotions/delete
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_promotion_id'
      responses:
        '204':
          description: Promotion deleted successfully
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - promotions
  /ad_accounts/{ad_account_id}/reports:
    get:
      summary: Get the account analytics report created by the async call
      description: |-
        This returns a URL to an analytics report given a token returned from the post request report creation call. You can use the URL to download the report. The link is valid for five minutes and the report is valid for one hour.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
      operationId: analytics/get_report
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_token_required'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdsAnalyticsGetAsyncResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
    post:
      summary: Create async request for an account analytics report
      description: |-
        This returns a token that you can use to download the report when it is ready. Note that this endpoint requires the parameters to be passed as JSON-formatted in the request body. This endpoint does not support URL query parameters.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - If granularity is not HOUR, you can pull data from up to 914 days before the current date in UTC time, with a maximum time range of 186 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
        - If level is PRODUCT_ITEM, you can pull data from up to 92 days before the current date in UTC time, with a maximum time range of 31 days.
        - If level is PRODUCT_ITEM, ad_ids and ad_statuses parameters are not allowed. Any columns related to pin promotion and ad is not allowed either.
      operationId: analytics/create_report
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdsAnalyticsCreateAsyncRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdsAnalyticsCreateAsyncResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
  /ad_accounts/{ad_account_id}/reports/brand_category_sku:
    get:
      summary: Get advertiser brand, category, SKU report
      description: |-
        <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
        Get a brand, category, SKU report for an ad account. This call returns the URL for the report that matches the token returned in the request to the Create brand, category, SKU report endpoint.
      operationId: analytics/get_conversion_product_report
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_token_required'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdsAnalyticsGetAsyncResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads analytics parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
    post:
      summary: Create a request for a brand, category, SKU report
      description: |-
        <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
        This creates an asynchronous brand, category, SKU report based on the given request. This request returns a token that you can use to download the report when it is ready.
      operationId: analytics/create_conversion_product_report
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConversionProductReportRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdsAnalyticsCreateAsyncResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics brand, category, SKU parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account ads analytics brand, category, SKU parameters
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
  /ad_accounts/{ad_account_id}/sandbox:
    delete:
      summary: Delete ads data for ad account in API Sandbox
      description: |-
        Delete an ad account and all the ads data associated with that account.
        A string message is returned indicating the status of the delete operation.

        Note: This endpoint is only allowed in the Pinterest API Sandbox (https://api-sandbox.pinterest.com/v5).
        Go to /docs/developer-tools/sandbox/ for more information.
      operationId: sandbox/delete
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: string
                example: Delete Success
        '400':
          description: Invalid ad account id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
  /ad_accounts/{ad_account_id}/ssio/accounts:
    get:
      summary: Get Salesforce account details including bill-to information.
      description: |-
        Get Salesforce account details including bill-to information to be used in insertion orders process for <code>ad_account_id</code>.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Finance, Campaign.
      operationId: ssio_accounts/get
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SSIOAccountResponse'
          description: Success
        '400':
          description: Invalid request parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid request parameter.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - billing
  /ad_accounts/{ad_account_id}/ssio/insertion_orders:
    post:
      summary: Create insertion order through SSIO.
      description: |-
        Create insertion order through SSIO for <code>ad_account_id</code>.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Finance, Campaign.
      operationId: ssio_insertion_order/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SSIOCreateInsertionOrderRequest'
        description: Order line to create.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SSIOCreateInsertionOrderResponse'
          description: Success
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid request.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - billing
    patch:
      summary: Edit insertion order through SSIO.
      description: |-
        Edit insertion order through SSIO for <code>ad_account_id</code>.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Finance, Campaign.
      operationId: ssio_insertion_order/edit
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SSIOEditInsertionOrderRequest'
        description: Order line to create.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SSIOEditInsertionOrderResponse'
          description: Success
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid request.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - billing
  /ad_accounts/{ad_account_id}/ssio/insertion_orders/status:
    get:
      summary: Get insertion order status by ad account id.
      description: |-
        Get insertion order status for account id <code>ad_account_id</code>.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Finance, Campaign.
      operationId: ssio_insertion_orders_status/get_by_ad_account
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Insertion orders status by ad acount id
                      items:
                        $ref: '#/components/schemas/SSIOInsertionOrderStatus'
          description: Success
        '400':
          description: Invalid request parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid request parameter.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - billing
  /ad_accounts/{ad_account_id}/ssio/insertion_orders/{pin_order_id}/status:
    get:
      summary: Get insertion order status by pin order id.
      description: |-
        Get insertion order status for pin order id <code>pin_order_id</code>.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Finance, Campaign.
      operationId: ssio_insertion_orders_status/get_by_pin_order_id
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_pin_order_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SSIOInsertionOrderStatusResponse'
          description: Success
        '400':
          description: Invalid request parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid request parameter.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - billing
  /ad_accounts/{ad_account_id}/ssio/order_lines:
    get:
      summary: Get Salesforce order lines by ad account id.
      description: |-
        Get Salesforce order lines for account id <code>ad_account_id</code>.
        - The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Finance, Campaign.
      operationId: ssio_order_lines/get_by_ad_account
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_pin_order_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: SSIO order lines by ad acount id
                      items:
                        $ref: '#/components/schemas/SSIOOrderLine'
          description: Success
        '400':
          description: Invalid request parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid request parameter.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - billing
  /ad_accounts/{ad_account_id}/targeting_analytics:
    get:
      summary: Get targeting analytics for an ad account
      description: |-
        Get targeting analytics for an ad account.
        For the requested account and metrics, the response will include the requested metric information
        (e.g. SPEND_IN_DOLLAR) for the requested target type (e.g. "age_bucket") for applicable values (e.g. "45-49"). <p/>
        - The token's user_account must either be the Owner of the specified ad account, or have one
        of the necessary roles granted to them via
        <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a>: Admin, Analyst, Campaign Manager.
        - If granularity is not HOUR, you can pull data from up to 90 days before the current date in UTC time, with a maximum time range of 90 days.
        - If granularity is HOUR, you can pull data from up to 8 days before the current date in UTC time, with a maximum time range of 3 days.
      operationId: ad_account_targeting_analytics/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_targeting_types'
      - $ref: '#/components/parameters/query_columns'
      - $ref: '#/components/parameters/query_granularity'
      - $ref: '#/components/parameters/query_conversion_attribution_click_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_engagement_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_view_window_days'
      - $ref: '#/components/parameters/query_conversion_attribution_conversion_report_time'
      - $ref: '#/components/parameters/query_attribution_types'
      - $ref: '#/components/parameters/query_reporting_timezone'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetricsResponse'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
  /ad_accounts/{ad_account_id}/targeting_templates:
    get:
      summary: List targeting templates
      description: Get a list of the targeting templates in the specified <code>ad_account_id</code>
      operationId: targeting_template/list
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_order'
      - in: query
        description: Include audience sizing in result or not
        name: include_sizing
        required: false
        schema:
          type: boolean
          default: false
      - description: Search keyword for targeting templates
        in: query
        name: search_query
        example: gaming
        required: false
        schema:
          type: string
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/TargetingTemplateGetResponseData'
          description: Success
        '400':
          description: Invalid ad account id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - targeting_template
    post:
      summary: Create targeting templates
      description: |-
        <p>Targeting templates allow advertisers to save a set of targeting details including audience lists,
         keywords & interest, demographics, and placements to use more than once during the campaign creation process.</p>
         <p>Templates can be used to build out basic targeting criteria that you plan to use across campaigns and to reuse
          performance targeting from prior campaigns for new campaigns.</p>
      operationId: targeting_template/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: targeting template creation entity
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TargetingTemplateCreate'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TargetingTemplateGetResponseData'
          description: Success
        '400':
          description: Invalid ad account id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - targeting_template
    patch:
      summary: Update targeting templates
      description: <p>Update the targeting template given advertiser ID and targeting
        template ID</p>
      operationId: targeting_template/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: Operation type and targeting template ID
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TargetingTemplateUpdateRequest'
      responses:
        '200':
          description: Success
        '400':
          description: Invalid ad account id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - targeting_template
  /ad_accounts/{ad_account_id}/templates:
    get:
      summary: List templates
      description: Gets all Templates associated with an ad account ID.
      operationId: templates/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/TemplateResponse'
          description: Success
        '400':
          description: Invalid ad account template parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account template parameters
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
  /ad_accounts/{ad_account_id}/templates/{template_id}/reports:
    post:
      summary: Create async request for an analytics report using a template
      description: |-
        This takes a template ID and an optional custom timeframe and constructs an asynchronous report based on the
        template. It returns a token that you can use to download the report when it is ready.
      operationId: analytics/create_template_report
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_template_id'
      - $ref: '#/components/parameters/query_start_date_async'
      - $ref: '#/components/parameters/query_end_date_async'
      - $ref: '#/components/parameters/query_granularity_async'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdsAnalyticsCreateAsyncResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics template parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account analytics template parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - ad_accounts
  /ad_accounts/{ad_account_id}/terms_of_service:
    get:
      description: Get the text of the terms of service and see whether the advertiser
        has accepted the terms of service.
      operationId: terms_of_service/get
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_include_html'
      - $ref: '#/components/parameters/query_tos_type'
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TermsOfService'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Get terms of service
      tags:
      - terms_of_service
  /advanced_auction/items/get:
    post:
      summary: Get item bid options (POST)
      description: |-
        Get the bid options for a batch of retail catalog items.

        The catalog must be owned by the "operation user_account". <a href="/docs/api-features/shopping-overview/#Update%20items%20in%20batch" target="_blank">See detailed documentation here.</a> By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: `Owner`, `Admin`.

        This endpoint is not available to all users.
      operationId: advanced_auction_items_get/post
      x-ratelimit-category: advanced_auction_read
      x-sandbox: enabled
      security:
      - pinterest_oauth2:
        - ads:read
        - catalogs:read
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to get bid options values for a batch of
          retail catalog items
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdvancedAuctionItemsGetRequest'
      responses:
        '200':
          description: Response containing the bid option values for the requested
            retail catalog items. Items that don't exist or do not have bid options
            set won't be present in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdvancedAuctionItems'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: 'Invalid request: {''catalog_id'': ''1234''} list of
                      retail catalog items not provided'
        '401':
          description: Not authenticated to get item bid options
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthenticatedAccess:
                  value:
                    code: 2
                    message: Authentication failed.
        '403':
          description: Not authorized to get item bid options
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - advanced_auction
  /advanced_auction/items/submit:
    post:
      summary: Operate on item level bid options
      description: |-
        This endpoint supports multiple operations on a set of one or more bid options (bid price and bid adjustments for targeting categories) for retail catalog items. These advanced auction settings are applied in campaigns using objective_type `CATALOG_SALES` and ad groups using bid_strategy_type `MAX_BID`.

        The catalog must be owned by the "operation user_account". <a href="/docs/api-features/modify-items-in-batch/" target="_blank">See detailed documentation here.</a> By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: `Owner`, `Admin`.

        This endpoint is not available to all users.
      operationId: advanced_auction_items_submit/post
      x-ratelimit-category: advanced_auction_write
      x-sandbox: enabled
      security:
      - pinterest_oauth2:
        - ads:write
        - catalogs:read
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to upsert or delete bid options for a batch
          of retail catalog items
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdvancedAuctionItemsSubmitRequest'
      responses:
        '200':
          description: Response containing the results of the item bid options operations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdvancedAuctionProcessedItems'
        '206':
          description: Response containing the results of the item bid options operations
            (where some/all operation results have errors)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdvancedAuctionProcessedItems'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: 'Invalid request: {''catalog_id'': ''1234''} list of
                      item bid option operations not provided'
        '401':
          description: Not authenticated to post item bid options
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthenticatedAccess:
                  value:
                    code: 2
                    message: Authentication failed.
        '403':
          description: Not authorized to post item bid options
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - advanced_auction
  /boards:
    get:
      summary: List boards
      description: |-
        Get a list of the boards owned by the "operation user_account" + group boards where this account is a collaborator
        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        Optional: Specify a privacy type (public, protected, or secret) to indicate which boards to return.
        - If no privacy is specified, all boards that can be returned (based on the scopes of the token and ad_account role if applicable) will be returned.
      tags:
      - boards
      operationId: boards/list
      security:
      - pinterest_oauth2:
        - boards:read
      - client_credentials:
        - boards:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      x-codeSamples:
      - lang: cURL
        label: curl
        source: |
          curl --location --request GET 'https://api.pinterest.com/v5/boards' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json'
      - lang: cURL
        label: curl (Sandbox)
        source: |
          curl --location --request GET 'https://api-sandbox.pinterest.com/v5/boards' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json'
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - name: privacy
        description: Privacy setting for a board.
        in: query
        required: false
        schema:
          type: string
          enum:
          - ALL
          - PROTECTED
          - PUBLIC
          - SECRET
          - PUBLIC_AND_SECRET
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Boards
                      items:
                        $ref: '#/components/schemas/Board'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    post:
      summary: Create board
      description: |-
        Create a board owned by the "operation user_account".
        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: boards/create
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
      - client_credentials:
        - boards:read
        - boards:write
      x-ratelimit-category: org_write
      x-sandbox: enabled
      x-codeSamples:
      - lang: python
        label: Python SDK
        source: |
          # Follow this link for initial setup: https://github.com/pinterest/pinterest-python-sdk#getting-started

          from pinterest.organic.boards import Board

          board_create=Board.create(
            name="Summer Recipes",
            description="My favorite summer recipes",
            privacy="PUBLIC"
          )
          print("Board Id: %s, Board name:%s"%(board_create.id, board_create.name))
      - lang: cURL
        label: curl
        source: |
          curl --location --request POST 'https://api.pinterest.com/v5/boards' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json' \
          --data-raw '{
                "name": "Summer Recipes",
                "description": "My favorite summer recipes",
                "privacy": "PUBLIC"
          }'
      - lang: cURL
        label: curl (Sandbox)
        source: |
          curl --location --request POST 'https://api-sandbox.pinterest.com/v5/boards' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json' \
          --data-raw '{
                "name": "Summer Recipes",
                "description": "My favorite summer recipes",
                "privacy": "PUBLIC"
          }'
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Create a board using a single board json object.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Board'
      responses:
        '201':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Board'
        '400':
          description: The board name is invalid or duplicated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: The board name is invalid or duplicated.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /boards/{board_id}:
    get:
      summary: Get board
      description: |-
        Get a board owned by the operation user_account - or a group board that has been shared with this account.
        - Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: boards/get
      security:
      - pinterest_oauth2:
        - boards:read
      - client_credentials:
        - boards:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      x-codeSamples:
      - lang: python
        label: Python SDK
        source: |
          # Follow this link for initial setup: https://github.com/pinterest/pinterest-python-sdk#getting-started

          from pinterest.organic.boards import Board
          # Board information can be fetched from profile page or from create/list board method here:
          # /docs/api/v5/#operation/boards/list
          BOARD_ID="<Add your board id here>"

          board_get = Board(board_id=BOARD_ID)
          print("Board Id: %s, Board name:%s"%(board_get.id, board_get.name))
      - lang: cURL
        label: curl
        source: |
          # Board information can be fetched from profile page or from create/list board method here:
          # /docs/api/v5/#operation/boards/list

          curl --location --request GET 'https://api.pinterest.com/v5/boards/<insert_your_board_id>' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json'
      - lang: cURL
        label: curl (Sandbox)
        source: |
          # Board information can be fetched from profile page or from create/ist board method here:
          # /docs/api/v5/#operation/boards/list

          curl --location --request GET 'https://api-sandbox.pinterest.com/v5/boards/<insert_your_board_id>' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json'
      parameters:
      - $ref: '#/components/parameters/path_board_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Board'
        '404':
          description: Board not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: Board not found.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    patch:
      summary: Update board
      description: |-
        Update a board owned by the "operating user_account".
        - Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: boards/update
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
      - client_credentials:
        - boards:read
        - boards:write
      x-ratelimit-category: org_write
      x-sandbox: enabled
      x-codeSamples:
      - lang: python
        label: Python SDK
        source: |
          # Follow this link for initial setup: https://github.com/pinterest/pinterest-python-sdk#getting-started

          from pinterest.organic.boards import Board
          # Board information can be fetched from profile page or from create/list board method here:
          # /docs/api/v5/#operation/boards/list
          BOARD_ID="<Add your board id here>"
          NEW_DESCRIPTION="Updated summer recipes!"
          NEW_PRIVACY="SECRET"

          board_update = Board(board_id=BOARD_ID)
          board_update.update_fields(
              description=NEW_DESCRIPTION,
              privacy=NEW_PRIVACY
          )
          print("Board Id: %s, Board description:%s, Board privacy:%s" %(board_update.id, board_update.description, board_update.privacy))
      - lang: cURL
        label: curl
        source: |
          # Board information can be fetched from profile page or from create/list board method here:
          # /docs/api/v5/#operation/boards/list

          curl --location --request PATCH 'https://api.pinterest.com/v5/boards/<insert_board_id>' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json' \
          --data-raw '{
                "name": "New Summer Recipes",
                "description": "Updated summer recipes!",
                "privacy": "SECRET"
          }'
      - lang: cURL
        label: curl (Sandbox)
        source: |
          # Board information can be fetched from profile page or from create/list board method here:
          # /docs/api/v5/#operation/boards/list

          curl --location --request PATCH 'https://api-sandbox.pinterest.com/v5/boards/<insert_board_id>' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json' \
          --data-raw '{
                "name": "New Summer Recipes",
                "description": "Updated summer recipes!",
                "privacy": "SECRET"
          }'
      parameters:
      - $ref: '#/components/parameters/path_board_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Update a board.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BoardUpdate'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Board'
        '400':
          description: Invalid board parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid board parameters.
        '403':
          description: Not authorized to update the board.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to update the board.
        '429':
          description: |-
            This request exceeded a rate limit. This can happen if the client exceeds one
            of the published rate limits or if multiple write operations are applied to
            an object within a short time window.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 8
                message: |-
                  This request exceeded a rate limit. This can happen if the client exceeds one
                  of the published rate limits or if multiple write operations are applied to
                  an object within a short time window.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    delete:
      summary: Delete board
      description: |-
        Delete a board owned by the "operation user_account".
        - Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: boards/delete
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
      x-ratelimit-category: org_write
      x-sandbox: enabled
      x-codeSamples:
      - lang: python
        label: Python SDK
        source: |
          # Follow this link for initial setup: https://github.com/pinterest/pinterest-python-sdk#getting-started

          from pinterest.organic.boards import Board
          # Board information can be fetched from profile page or from create/list board method here:
          # /docs/api/v5/#operation/boards/list
          BOARD_ID="<Add your board id here>"

          board_delete=Board.delete(board_id=BOARD_ID)
          print("Board was deleted? %s" % (board_delete))
      - lang: cURL
        label: curl
        source: |
          # Board information can be fetched from profile page or create/from list board method here:
          # /docs/api/v5/#operation/boards/list

          curl --request DELETE 'https://api.pinterest.com/v5/boards/<insert_board_id>' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json' \
      - lang: cURL
        label: curl (Sandbox)
        source: |
          # Board information can be fetched from profile page or from create/list board method here:
          # /docs/api/v5/#operation/boards/list

          curl --request DELETE 'https://api-sandbox.pinterest.com/v5/boards/<insert_board_id>' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json' \
      parameters:
      - $ref: '#/components/parameters/path_board_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '204':
          description: Board deleted successfully
        '403':
          description: Not authorized to delete the board.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to delete the board.
        '404':
          description: Board not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: Board not found.
        '409':
          description: Could not get exclusive access to delete the board.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 409
                message: Could not get exclusive access to delete the board.
        '429':
          description: |-
            This request exceeded a rate limit. This can happen if the client exceeds one
            of the published rate limits or if multiple write operations are applied to
            an object within a short time window.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 8
                message: |-
                  This request exceeded a rate limit. This can happen if the client exceeds one
                  of the published rate limits or if multiple write operations are applied to
                  an object within a short time window.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /boards/{board_id}/pins:
    get:
      summary: List Pins on board
      description: |-
        Get a list of the Pins on a board owned by the "operation user_account" - or on a group board that has been shared with this account.
        - Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: boards/list_pins
      security:
      - pinterest_oauth2:
        - boards:read
        - pins:read
      - client_credentials:
        - boards:read
        - pins:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_board_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_creative_types'
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_pin_metrics'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Pins
                      items:
                        $ref: '#/components/schemas/Pin'
        '404':
          description: Board not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: Board not found.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /boards/{board_id}/sections:
    get:
      summary: List board sections
      description: |-
        Get a list of all board sections from a board owned by the "operation user_account" - or a group board that has been shared with this account.
        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: board_sections/list
      security:
      - pinterest_oauth2:
        - boards:read
      - client_credentials:
        - boards:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_board_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Board sections
                      items:
                        $ref: '#/components/schemas/BoardSection'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    post:
      summary: Create board section
      description: |-
        Create a board section on a board owned by the "operation user_account" - or on a group board that has been shared with this account.
        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: board_sections/create
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
      x-ratelimit-category: org_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_board_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Create a board section.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BoardSection'
      responses:
        '201':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BoardSection'
        '400':
          description: Invalid board section parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid board section parameters.
        '403':
          description: Not authorized to create board sections.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to create board sections.
        '409':
          description: Could not get exclusive access to the board to create a new
            section.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 409
                message: Could not get exclusive access to the board to create a new
                  section.
        '500':
          description: Could not create a new board section.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 500
                message: Could not create a new board section.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /boards/{board_id}/sections/{section_id}:
    patch:
      summary: Update board section
      description: |-
        Update a board section on a board owned by the "operation user_account" - or on a group board that has been shared with this account.
        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: board_sections/update
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
      x-ratelimit-category: org_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_board_id'
      - $ref: '#/components/parameters/path_board_section_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Update a board section.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BoardSection'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BoardSection'
        '400':
          description: Invalid board section parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid board section parameters.
        '403':
          description: Not authorized to update board section.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to update board section.
        '409':
          description: Board section conflict.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 409
                message: Board section conflict.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    delete:
      summary: Delete board section
      description: |-
        Delete a board section on a board owned by the "operation user_account" - or on a group board that has been shared with this account.
        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: board_sections/delete
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
      x-ratelimit-category: org_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_board_id'
      - $ref: '#/components/parameters/path_board_section_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '204':
          description: Board section deleted successfully
        '403':
          description: Not authorized to delete board section.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to delete board section.
        '404':
          description: Board section not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: Board section not found.
        '409':
          description: Board section conflict.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 409
                message: Board section conflict.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /boards/{board_id}/sections/{section_id}/pins:
    get:
      summary: List Pins on board section
      description: |-
        Get a list of the Pins on a board section of a board owned by the "operation user_account" - or on a group board that has been shared with this account.
        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
      tags:
      - boards
      operationId: board_sections/list_pins
      security:
      - pinterest_oauth2:
        - boards:read
        - pins:read
      - client_credentials:
        - boards:read
        - pins:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_board_id'
      - $ref: '#/components/parameters/path_board_section_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Pins
                      items:
                        $ref: '#/components/schemas/Pin'
        '403':
          description: Not authorized to access Pins on board section.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to access Pins on board section.
        '404':
          description: Board or section not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: Board or section not found.
        '409':
          description: Board section conflict.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 409
                message: Board section conflict.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /businesses/employers:
    get:
      summary: List business employers for user
      description: Get all of the viewing user's business employers.
      operationId: get/business_employers
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      description: List of employers.
                      items:
                        $ref: '#/components/schemas/UserBusinessRoleBinding'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_relationships
  /businesses/invites:
    patch:
      summary: Accept or decline an invite/request
      description: Accept or decline invites or requests.
      operationId: respond_business_access_invites
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthRespondInvitesBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RespondToInvitesResponseArray'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_invite
  /businesses/{business_id}/system_users/{system_user_id}:
    patch:
      summary: Update a system user information.
      description: Update a system user information such as name.
      operationId: system_user/update
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - name: system_user_id
        in: path
        description: Unique identifier of a system user.
        example: '729090764583391194'
        required: true
        schema:
          type: string
          pattern: ^\d+$
          minLength: 1
          maxLength: 20
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: New system user name
                  example: Billing API
                  type: string
              required:
              - name
        required: true
      responses:
        '200':
          description: System user updated successfully.
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid parameters.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_relationships
  /businesses/{business_id}/assets/{asset_id}/members:
    get:
      summary: Get members with access to asset
      description: Get all the members the requesting business has granted access
        to on the given asset.
      operationId: business_asset_members/get
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - $ref: '#/components/parameters/path_asset_id'
      - $ref: '#/components/parameters/fetch_system_users'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_business_access_start_index'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      description: List of members with permissions to the asset.
                      items:
                        $ref: '#/components/schemas/UserSingleAssetBinding'
          description: Sucess
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
  /businesses/{business_id}/assets/{asset_id}/partners:
    get:
      summary: Get partners with access to asset
      description: |-
        Get all the partners the requesting business has granted access to on the given asset.
        Note: If the asset has been shared with you, an empty array will be returned. This is because an asset shared with
        you cannot be shared with a different partner.
      operationId: business_asset_partners/get
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - $ref: '#/components/parameters/path_asset_id'
      - $ref: '#/components/parameters/query_business_access_start_index'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      description: List of partners with permissions to the asset.
                      items:
                        $ref: '#/components/schemas/UserSingleAssetBinding'
          description: Sucess
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
  /businesses/{business_id}/invites/assets/access:
    post:
      summary: Update invite/request with an asset permission
      description: |-
        Assign asset permissions information to an existing invite/request. Can be used to:
        - Request access to a partner's asset. Note: This is only for when no existing partnership exists. If an existing
          partnership exists, use "Create a request to access an existing partner's assets" to request access to your
          partner's assets.
            - invite_type="PARTNER_REQUEST"
        - Invite a partner to access your business assets. Note: This is only for when there is no existing partnership.
          If there is an existing partnership, use "Assign/Update partner asset permissions" to assign a partner access to
          new assets.
            - invite_type="PARTNER_INVITE"
        - Invite a member to access your business assets. Note: This is only for when there is no existing membership.
          If there is an existing membership, use "Assign/Update member asset permissions" to assign a member access to new
          assets.
            - invite_type="MEMBER_INVITE"

        To learn more about permission levels, visit https://help.pinterest.com/en/business/article/business-manager-overview.
      operationId: create_asset_invites
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAssetInvitesRequest'
        description: |
          A list of invites/requests together with the asset permissions to be assigned to the invite/request.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateInvitesResultsResponseArray'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_invite
  /businesses/{business_id}/requests/assets/access:
    post:
      summary: Create a request to access an existing partner's assets.
      description: Create a request to access an existing partner's assets with the
        specified permissions. The request will be sent to the partner for approval.
        The assets that can be requested are ad accounts and profiles.
      operationId: asset_access_requests/create
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAssetAccessRequestBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateAssetAccessRequestResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_invite
  /businesses/{business_id}/members:
    get:
      summary: Get business members
      description: |-
        Get all members of the specified business.
        The return response will include the member's business_role and assets they have access to if assets_summary=TRUE
      operationId: get/business_members
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - $ref: '#/components/parameters/fetch_system_users'
      - $ref: '#/components/parameters/query_assets_summary'
      - name: business_roles
        in: query
        description: A list of business roles to filter the members by. Only members
          whose roles are in the specified roles will be returned.
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/MemberBusinessRole'
      - name: member_ids
        in: query
        description: A list of business members ids separated by comma.
        example: 00101010101,2222220101
        required: false
        schema:
          type: string
          maxLength: 500
      - $ref: '#/components/parameters/query_business_access_start_index'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      description: List of business members.
                      items:
                        $ref: '#/components/schemas/UserBusinessRoleBinding'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_relationships
    patch:
      description: Update a member's business role within the business.
      summary: Update member's business role
      operationId: update/business_memberships
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_id'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              minItems: 1
              items:
                $ref: '#/components/schemas/UpdateMemberBusinessRoleBody'
        description: List of objects with the member id and the business_role.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateMemberResultsResponseArray'
          description: response
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_relationships
    delete:
      description: Terminate memberships between the specified members and your business.
      summary: Terminate business memberships
      operationId: delete_business_membership
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_business_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MembersToDeleteBody'
        description: List of members with role to delete.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletedMembersResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_relationships
  /businesses/{business_id}/assets:
    get:
      summary: List business assets
      description: Get all the assets the requesting business has access to. This
        includes assets the business owns and assets the business has access to through
        partnerships.
      operationId: business_assets/get
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - name: permissions
        in: query
        description: A list of asset permissions used to filter the assets. Only assets
          where the requesting business has at least one of the specified permissions
          will be returned.
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/PermissionsWithOwner'
      - name: child_asset_id
        in: query
        description: A child asset unique identifier. Used to fetch asset groups that
          contain the asset id as a child.
        required: false
        schema:
          type: string
          pattern: ^\d+$
          example: '549764894835'
          minLength: 1
          maxLength: 20
      - name: asset_group_id
        in: query
        description: An asset group unique identifier. Used to fetch assets contained
          within the specified asset group.
        required: false
        schema:
          type: string
          pattern: ^\d+$
          example: '7078106104032'
          minLength: 1
          maxLength: 20
      - $ref: '#/components/parameters/query_resource_type'
      - $ref: '#/components/parameters/query_business_access_start_index'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      description: List of assets the requesting business has access
                        to.
                      items:
                        $ref: '#/components/schemas/GetBusinessAssetsResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
  /businesses/{business_id}/members/{member_id}/assets:
    get:
      summary: Get assets assigned to a member
      description: |-
        Get assets on which you assigned asset permissions to the given member. Can be used to:
        - get all assets, regardless of asset type or
        - get assets of one asset type by using the asset_type query.
        The return response will include the permissions the member has to that asset and the asset type.
      operationId: business_member_assets/get
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - $ref: '#/components/parameters/path_business_member_user'
      - $ref: '#/components/parameters/query_resource_type'
      - $ref: '#/components/parameters/query_business_access_start_index'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      description: List asset permissions the given member was granted.
                      items:
                        $ref: '#/components/schemas/AssetIdPermissions'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
  /businesses/{business_id}/members/assets/access:
    patch:
      description: |
        Grant multiple members access to assets and/or update multiple member's exisiting permissions to an asset.
        Note: Not all listed permissions are applicable to each asset type. For example, PROFILE_PUBLISHER would not be applicable to an asset of type AD_ACCOUNT. The permission level PROFILE_PUBLISHER is only available to an asset of the type PROFILE.
      summary: Assign/Update member asset permissions
      operationId: business_members_asset_access/update
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateMemberAssetAccessBody'
        description: List of member asset permissions to create or update.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateMemberAssetsResultsResponseArray'
          description: response
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
    delete:
      description: Terminate multiple members' access to an asset.
      summary: Delete member access to asset
      operationId: business_members_asset_access/delete
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - accesses
              properties:
                accesses:
                  type: array
                  minItems: 1
                  maxItems: 100
                  description: List of members asset access to be deleted
                  items:
                    type: object
                    required:
                    - asset_id
                    - member_id
                    properties:
                      asset_id:
                        type: string
                        description: Id of the asset on which to remove member permissions.
                        example: '549755885175'
                        maxLength: 25
                        pattern: ^\d+$
                      member_id:
                        type: string
                        description: Unique identifier of the member on which to perform
                          the asset permission removal
                        example: '140943737684417'
                        maxLength: 25
                        pattern: ^\d+$
        description: List member assset permissions to delete.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteMemberAccessResultsResponseArray'
          description: response
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
  /businesses/{business_id}/invites:
    get:
      summary: Get invites/requests
      description: Get the membership/partnership invites and/or requests for the
        authorized user.
      operationId: get/invites
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_non_system_business_user'
      - $ref: '#/components/parameters/query_is_member'
      - $ref: '#/components/parameters/query_invite_status'
      - $ref: '#/components/parameters/query_invite_type'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      description: List of invite and request data.
                      items:
                        $ref: '#/components/schemas/InviteResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_invite
    post:
      summary: Create invites or requests
      description: |-
        Create batch invites or requests. Can create batch invites or requests as described below.
        - Invite members to join the business. This would required specifying the following:
            - invite_type="MEMBER_INVITE"
            - business_role="EMPLOYEE" OR business_role="BIZ_ADMIN" (To learn more about business roles, visit
            https://help.pinterest.com/en/business/article/profile-permissions-in-business-access.)
            - members
        - Invite partners to access your business assets. This would require specifying the following:
            - invite_type="PARTNER_INVITE"
            - business_role="PARTNER"
            - partners
        - Request to be a partner so you can access their assets. This would require specifying the following:
            - invite_type="PARTNER_REQUEST"
            - business_role="PARTNER"
            - partners
      operationId: create_membership_or_partnership_invites
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_non_system_business_user'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateMembershipOrPartnershipInvitesBody'
        description: 'An object with the properties: invite_type, partners, members,
          business_role'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateInvitesResultsResponseArray'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_invite
    delete:
      summary: Cancel invites/requests
      description: Cancel membership/partnership invites and/or requests.
      operationId: cancel_invites_or_requests
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_non_system_business_user'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CancelInvitesBody'
        description: A list with invite ids
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteInvitesResultsResponseArray'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_invite
  /businesses/{business_id}/partners/assets:
    patch:
      summary: Assign/Update partner asset permissions
      description: |-
        Grant multiple partners access to assets and/or update multiple partner's exisiting permissions to an asset.
        If your partner already had permissions on the asset, they will be overriden with the new permissions you assign to them.
        To learn more about permission levels, visit https://help.pinterest.com/en/business/article/business-manager-overview

        Note: Not all listed permissions are applicable to each asset type. For example, PROFILE_PUBLISHER would not be
        applicable to an asset of type AD_ACCOUNT. The permission level PROFILE_PUBLISHER is only available to an asset of
        the type PROFILE.
      operationId: update_partner_asset_access_handler_impl
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        description: A list of assets and permissions to assign to your partners.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePartnerAssetAccessBody'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdatePartnerAssetsResultsResponseArray'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
    delete:
      summary: Delete partner access to asset
      description: |-
        Terminate multiple partners' access to an asset. If
        - partner_type=INTERNAL: You will terminate a partner's asset access to your business assets.
        - partner_type=EXTERNAL: You will terminate your own access to your partner's business assets.
      operationId: delete_partner_asset_access_handler_impl
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeletePartnerAssetAccessBody'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletePartnerAssetsResultsResponseArray'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
  /businesses/{business_id}/partners/{partner_id}/assets:
    get:
      summary: Get assets assigned to a partner or assets assigned by a partner
      description: |-
        Can be used to get the business assets your partner has granted you access to or the business assets you have
        granted your partner access to. If you specify:
        - partner_type=INTERNAL, you will retrieve your business assets that the partner has access to.
        - partner_type=EXTERNAL, you will retrieve the partner's business assets that the partner has granted you access to.
      operationId: business_partner_asset_access/get
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - $ref: '#/components/parameters/path_business_partner_user'
      - name: partner_type
        in: query
        description: |-
          Specifies whether to fetch internal or external (shared) partners.
          If partner_type=INTERNAL, the asset being queried is for accesses the partner has to your business assets.<br>
          If partner_type=EXTERNAL, the asset being queried is for the accesses you have to the partner's business asset.
        example: INTERNAL
        required: false
        schema:
          allOf:
          - $ref: '#/components/schemas/PartnerType'
          - default: INTERNAL
      - $ref: '#/components/parameters/query_resource_type'
      - $ref: '#/components/parameters/query_business_access_start_index'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      description: List assets on which you granted access to your
                        partner or assets on which your partner has granted you access.
                      items:
                        $ref: '#/components/schemas/GetPartnerAssetsResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
  /businesses/{business_id}/partners:
    get:
      summary: Get business partners
      description: |-
        Get all partners of the specified business.

        If the assets_summary=TRUE and:
        - partner_type=INTERNAL, the business assets returned are your business assets the partner has access to.
        - partner_type=EXTERNAL, the business assets returned are your partner's business assets the partner has granted you
          access to.
      operationId: get/business_partners
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - $ref: '#/components/parameters/query_assets_summary'
      - $ref: '#/components/parameters/query_business_partner_type'
      - name: partner_ids
        in: query
        description: A list of business partner ids separated by commas used to filter
          the results. Only partners with the specified ids will be returned.
        example: 00101010101,2222220101
        required: false
        schema:
          type: string
          maxLength: 500
      - $ref: '#/components/parameters/query_business_access_start_index'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      description: List of business partners.
                      items:
                        $ref: '#/components/schemas/UserBusinessRoleBinding'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_relationships
    delete:
      summary: Terminate business partnerships
      description: |-
        Terminate partnerships between the specified partners and your business.
        Note: You may only batch terminate partners of the same partner type.
      operationId: delete_business_partners
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeletePartnersRequest'
        description: |
          An object containing a "partner_ids" property composed of a list of partner IDs and a "partners_type" property specifying the type of partners to delete.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletePartnersResponse'
          description: Success
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: A supplied partner id doesn't exist
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_relationships
  /businesses/{business_id}/audiences:
    get:
      summary: List received audiences for a business
      description: Get a list of received audiences for the given business.
      operationId: shared_audiences_for_business/list
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Audience'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audience_sharing
  /businesses/{business_id}/audiences/shared/accounts:
    get:
      summary: List accounts with access to an audience owned by a business
      description: |-
        List all ad accounts and/or businesses that have access to a specific audience.
        The audience must either be owned by an ad account in the requesting business, or it must have been shared with the requesting business.
        If the requesting business is not the owner of the audience, only ad accounts owned by the requesting business will be returned.
      operationId: business_account_audiences_shared_accounts/list
      security:
      - pinterest_oauth2:
        - biz_access:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      - $ref: '#/components/parameters/query_audience_id'
      - $ref: '#/components/parameters/query_account_type'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/SharedAudienceAccount'
        '400':
          description: Invalid business audiences shared accounts parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid business audiences shared accounts parameters.
        '404':
          description: Shared accounts not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audience_sharing
  /businesses/{business_id}/audiences/ad_accounts/shared:
    patch:
      summary: Update audience sharing from a business to ad accounts
      description: From a business, share a specific audience with other ad account(s),
        or revoke access to a previously shared audience. <ul> <li>If the business
        is the owner of the audience, it can share with any ad account within the
        same business hierarchy.</li> <li>If the business is the recipient of the
        audience, it can share with any of its owned ad accounts.</li> </ul> This
        endpoint is not available to all apps.<a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn
        more</a>.
      operationId: update_business_to_ad_account_shared_audience
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SharedAudience'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedAudienceResponse'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audience_sharing
  /businesses/{business_id}/audiences/businesses/shared:
    patch:
      summary: Update audience sharing between businesses
      description: From a business, share a specific audience with another business
        account, or revoke access to a previously shared audience. Only the audience
        owner can share the audience with other businesses, and the recipient business
        must be within the same business hierarchy.<br> This endpoint is not available
        to all apps.<a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn
        more</a>.
      operationId: update_business_to_business_shared_audience
      security:
      - pinterest_oauth2:
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BusinessSharedAudience'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessSharedAudienceResponse'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid business id
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - audience_sharing
  /businesses/{business_id}/asset_groups:
    post:
      summary: Create a new asset group.
      description: "Create a new asset group with the specified parameters.\n- An\
        \ <a href=\"https://help.pinterest.com/en/business/article/asset-groups\"\
        >asset group</a> is a custom group of assets based on how you\u2019d like\
        \ to manage your accounts."
      operationId: asset_group/create
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAssetGroupBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateAssetGroupResponse'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid parameters.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
    patch:
      summary: Update asset groups.
      description: Update a batch of asset groups with the specified parameters.
      operationId: asset_group/update
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAssetGroupBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateAssetGroupResponse'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid parameters.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
    delete:
      summary: Delete asset groups.
      description: Delete a batch of asset groups.
      operationId: asset_group/delete
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_user'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteAssetGroupBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteAssetGroupResponse'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid parameters.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_assets
  /business_access/business_hierarchy/{business_hierarchy_id}/brand_accounts:
    post:
      summary: Create a Brand Account
      description: Create a Brand Account that will be a child business of a business
        hierarchy. Request must contain name, username, and country.
      operationId: brand_accounts/create
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_hierarchy_id'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: Brand Account name
                  example: Canada Stores
                  type: string
                username:
                  description: Brand Account username
                  example: canada_stores
                  type: string
                country:
                  $ref: '#/components/schemas/Country'
                about:
                  description: Brand Account about information
                  example: Stores in Canada
                  type: string
                website:
                  description: Brand Account website
                  example: https://www.example.com
                  type: string
                profile_image:
                  title: Image Base64
                  description: Base64-encoded image media source
                  type: object
                  properties:
                    content_type:
                      type: string
                      enum:
                      - image/jpeg
                      - image/png
                    data:
                      type: string
                      pattern: '[a-zA-Z0-9+\/=]+'
                  required:
                  - content_type
                  - data
              required:
              - name
              - username
              - country
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  brand_account_id:
                    type: string
                    description: id of the newly created brand account
                    example: '666791336903426391'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid parameters.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_relationships
  /business_access/business_hierarchy/{business_hierarchy_id}/brand_accounts/{brand_account_id}:
    patch:
      summary: Update a Brand Account
      description: Update an existing Brand Account
      operationId: brand_accounts/update
      security:
      - pinterest_oauth2:
        - biz_access:read
        - biz_access:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_business_hierarchy_id'
      - name: brand_account_id
        in: path
        description: Unique identifier of a brand account.
        example: '729090764583391194'
        required: true
        schema:
          type: string
          pattern: ^\d+$
          minLength: 1
          maxLength: 20
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: Brand Account name
                  example: Canada Stores
                  type: string
                username:
                  description: Brand Account username
                  example: canada_stores
                  type: string
                country:
                  $ref: '#/components/schemas/Country'
                about:
                  description: Brand Account about information
                  example: Stores in Canada
                  type: string
                website:
                  description: Brand Account website
                  example: https://www.example.com
                  type: string
                profile_image:
                  title: Image Base64
                  description: Base64-encoded image media source
                  type: object
                  properties:
                    content_type:
                      type: string
                      enum:
                      - image/jpeg
                      - image/png
                    data:
                      type: string
                      pattern: '[a-zA-Z0-9+\/=]+'
                  required:
                  - content_type
                  - data
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  brand_account_id:
                    type: string
                    description: id of the newly created brand account
                    example: '666791336903426391'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid parameters.
        '401':
          description: Not authenticated to update Brand Account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthenticatedAccess:
                  value:
                    code: 2
                    message: Authentication failed.
        '403':
          description: Not authorized to update Brand Account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Brand account not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: User not found.
        '409':
          description: This account is not a brand account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 409
                message: This account is not a brand account.
        '429':
          description: |-
            This request exceeded a rate limit. This can happen if the client exceeds one
            of the published rate limits within a short time window.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 30
                message: |-
                  This request exceeded a rate limit. This can happen if the client exceeds one
                  of the published rate limits within a short time window.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - business_access_relationships
  /catalogs:
    get:
      x-ratelimit-category: catalogs_read
      summary: List catalogs
      description: |-
        Fetch catalogs owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: catalogs/list
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Catalog'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: Parameter 'page_size' was not numeric (was 3e)"
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalogs
    post:
      x-ratelimit-category: catalogs_write
      summary: Create catalog
      description: |-
        Create a new catalog owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>

        Note: Access to the Product and Creative Assets catalog type is restricted to a specific group of users.
        If you require access, please reach out to your partner manager.
      operationId: catalogs/create
      security:
      - pinterest_oauth2:
        - catalogs:write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to created a feed.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CatalogsCreateRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: 'Invalid request: ...'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalogs
  /catalogs/available_filter_values:
    get:
      x-ratelimit-category: catalogs_read
      summary: List available filter values
      description: |-
        Get the available filter attributes and values associated with a given feed or catalog owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
        - <code>country</code>, <code>language</code>, and <code>feed_id</code> are only used in retail catalogs.
        - Note: It is not guaranteed that all available filter values will be returned. Instead this endpoint will return values from a sample of up to 1000 items.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: catalogs/available_filter_values
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - description: Filter entities for a given catalog_id.
        in: query
        required: true
        name: catalog_id
        schema:
          type: string
          pattern: ^\d+$
      - $ref: '#/components/parameters/query_catalogs_feed_id'
      - name: country
        in: query
        description: Country for the Catalogs Items
        example: US
        required: false
        schema:
          $ref: '#/components/schemas/Country'
      - name: language
        in: query
        description: Language for the Catalogs Items
        example: en-US
        required: false
        schema:
          $ref: '#/components/schemas/CatalogsLocale'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsAvailableFilterValues'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '403':
          description: Forbidden. Account not authorized to access available filter
            values.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '404':
          description: Data feed not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedNotFound:
                  value:
                    code: 4161
                    message: Sorry! We could not find your catalogs feed.
        '409':
          description: Can't access this feature without an existing catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalogs
  /catalogs/feeds:
    get:
      x-ratelimit-category: catalogs_read
      summary: List feeds
      description: |-
        Fetch feeds owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        For Retail partners, refer to <a href='https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs'>Before you get started with Catalogs</a>. For Hotel parterns, refer to <a href='/docs/api-features/shopping-overview/'>Pinterest API for shopping</a>.
      operationId: feeds/list
      security:
      - pinterest_oauth2:
        - catalogs:read
      - client_credentials:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_catalogs_catalog_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/CatalogsFeed'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: Parameter 'page_size' was not numeric (was 3e)"
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_feeds
    post:
      x-ratelimit-category: catalogs_write
      summary: Create feed
      description: |-
        Create a new feed owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Please, be aware that "default_country"
        and "default_locale" are not required in the spec for forward compatibility
        but for now the API will not accept requests without those fields.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        For Retail partners, refer to <a href='https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs'>Before you get started with Catalogs</a>. For Hotel parterns, refer to <a href='/docs/api-features/shopping-overview/'>Pinterest API for shopping</a>.

        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.
      operationId: feeds/create
      security:
      - pinterest_oauth2:
        - catalogs:read
        - catalogs:write
      - client_credentials:
        - catalogs:read
        - catalogs:write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to created a feed.
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/CatalogsVerticalFeedsCreateRequest'
              - $ref: '#/components/schemas/CatalogsFeedsCreateRequest'
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsFeed'
          description: Success
        '400':
          description: Invalid feed parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: 'Invalid request: ...'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '403':
          description: Business account required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                BusinessAccountRequired:
                  value:
                    code: 654
                    message: You must have a business account to operate as merchant.
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
        '409':
          description: User website required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UserWebsiteRequired:
                  value:
                    code: 4168
                    message: User does not have a website.
                UserWebsiteNotVerified:
                  value:
                    code: 4169
                    message: User does not have a verified website.
        '422':
          description: Unique feed name is required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedDuplicatedName:
                  value:
                    code: 4170
                    message: The feed name already exists.
        '501':
          description: Not implemented (absent "default_country" or "default_locale").
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NotImplemented:
                  value:
                    code: 4181
                    message: Not implemented at the moment. Please, see documentation
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_feeds
  /catalogs/feeds/{feed_id}:
    get:
      x-ratelimit-category: catalogs_read
      summary: Get feed
      description: |-
        Get a single feed owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        For Retail partners, refer to <a href='https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs'>Before you get started with Catalogs</a>. For Hotel parterns, refer to <a href='/docs/api-features/shopping-overview/'>Pinterest API for shopping</a>.
      operationId: feeds/get
      security:
      - pinterest_oauth2:
        - catalogs:read
      - client_credentials:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_feed_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsFeed'
          description: Success
        '400':
          description: Invalid feed parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''feed_id'' value ''1511851494501_'' must match the
                      pattern: ^\d+$"}'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '404':
          description: Data feed not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedNotFound:
                  value:
                    code: 4161
                    message: Sorry! We could not find your catalogs feed.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_feeds
    patch:
      x-ratelimit-category: catalogs_write
      summary: Update feed
      description: |-
        Update a feed owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        For Retail partners, refer to <a href='https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs'>Before you get started with Catalogs</a>. For Hotel parterns, refer to <a href='/docs/api-features/shopping-overview/'>Pinterest API for shopping</a>.

        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.
      operationId: feeds/update
      security:
      - pinterest_oauth2:
        - catalogs:read
        - catalogs:write
      - client_credentials:
        - catalogs:read
        - catalogs:write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_feed_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to update a feed.
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/CatalogsVerticalFeedsUpdateRequest'
              - $ref: '#/components/schemas/CatalogsFeedsUpdateRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsFeed'
          description: Success
        '400':
          description: Invalid feed parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: 'Invalid request: ...'
        '403':
          description: Forbidden. Account not approved for feed mutations yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '404':
          description: Data feed not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedNotFound:
                  value:
                    code: 4161
                    message: Sorry! We could not find your catalogs feed.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_feeds
    delete:
      x-ratelimit-category: catalogs_write
      summary: Delete feed
      description: |-
        Delete a feed owned by the "operating user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        For Retail partners, refer to <a href='https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs'>Before you get started with Catalogs</a>. For Hotel parterns, refer to <a href='/docs/api-features/shopping-overview/'>Pinterest API for shopping</a>.
      operationId: feeds/delete
      security:
      - pinterest_oauth2:
        - catalogs:read
        - catalogs:write
      - client_credentials:
        - catalogs:read
        - catalogs:write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_feed_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '204':
          description: Feed deleted successfully.
        '400':
          description: Invalid feed parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''feed_id'' value ''1511851494501_'' must match the
                      pattern: ^\d+$"}'
        '403':
          description: Forbidden. Account not approved for feed mutations yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '404':
          description: Data feed not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedNotFound:
                  value:
                    code: 4161
                    message: Sorry! We could not find your catalogs feed.
        '409':
          description: Conflict. Can't delete a feed with active promotions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedHasActivePromotions:
                  value:
                    code: 4162
                    message: We can't disable a Product Group with active promotions.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_feeds
  /catalogs/feeds/{feed_id}/ingest:
    post:
      x-ratelimit-category: catalogs_write
      summary: Ingest feed items
      description: |-
        Ingest items for a given feed owned by the "operation user_account".

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>

        Note: This endpoint is restricted to a specific group of users. If you require access, please reach out to your partner manager.
      operationId: feeds/ingest
      security:
      - pinterest_oauth2:
        - catalogs:write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_feed_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          description: The ingestion process was successfully started.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsFeedIngestion'
        '400':
          description: Invalid feed parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''feed_id'' value ''1511851494501_'' must match the
                      pattern: ^\d+$"}'
        '403':
          description: Forbidden. Account not approved for feed mutations yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '404':
          description: Data feed not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedNotFound:
                  value:
                    code: 4161
                    message: Sorry! We could not find your catalogs feed.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_feeds
  /catalogs/feeds/{feed_id}/processing_results:
    get:
      x-ratelimit-category: catalogs_read
      summary: List feed processing results
      description: |-
        Fetch a feed processing results owned by the "operation user_account". Please note that for now the bookmark parameter is not functional and only the first page will be available until it is implemented in some release in the near future.
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: feed_processing_results/list
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_feed_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/CatalogsFeedProcessingResult'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: Parameter 'page_size' was not numeric (was 3e)"
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '404':
          description: Feed not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedNotFound:
                  value:
                    code: 4161
                    message: Sorry! We could not find your catalogs feed.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_feeds
  /catalogs/processing_results/{processing_result_id}/item_issues:
    get:
      x-ratelimit-category: catalogs_read
      summary: List item issues
      description: |-
        List item validation issues for a given feed processing result owned by the "operation user_account". Up to 20 random samples of affected items are returned for each error and warning code. Please note that for now query parameters 'item_numbers' and 'item_validation_issue' cannot be used simultaneously until it is implemented in some release in the future.
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        Note: To get a list of all affected items instead of sampled issues, please refer to <a href='/docs/api/v5/#operation/reports/create'>Build catalogs report</a> and <a href='/docs/api/v5/#operation/reports/get'>Get catalogs report</a> endpoints. Moreover, they support multiple types of catalogs.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: items_issues/list
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/path_catalogs_processing_result_id'
      - $ref: '#/components/parameters/query_catalogs_item_numbers'
      - $ref: '#/components/parameters/query_catalogs_item_validation_issue'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/CatalogsItemValidationIssues'
          description: Success
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '404':
          description: Processing Result not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ProcessingResultFound:
                  value:
                    code: 4184
                    message: Sorry! We could not find your processing result.
        '501':
          description: Not implemented.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NotImplemented:
                  value:
                    code: 4181
                    message: Not implemented at the moment. Please, see documentation.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_feeds
  /catalogs/items:
    post:
      summary: Get catalogs items (POST)
      description: |-
        Get the items of the catalog owned by the "operation user_account". <a href="/docs/api-features/shopping-overview/#Update%20items%20in%20batch" target="_blank">See detailed documentation here.</a>
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> 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.
      operationId: items/post
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-ratelimit-category: catalogs_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to get catalogs items
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CatalogsItemsRequest'
      responses:
        '200':
          description: Response containing the requested catalogs items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsItems'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: 'Invalid request: {''country'': ''US'', ''language'':
                      ''EN'', ''filters'': {''catalog_type'': ''RETAIL'', ''item_ids'':
                      ''test0''}} (''test0'' is not of type array)'
        '401':
          description: Not authorized to access catalogs items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 2
                    message: Authentication failed.
        '403':
          description: Not authorized to access catalogs items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_items
  /catalogs/items/batch:
    post:
      summary: Operate on item batch
      description: |-
        This endpoint supports multiple operations on a set of one or more catalog items owned by the "operation user_account". <a href="/docs/api-features/shopping-overview/#Update%20items%20in%20batch" target="_blank">See detailed documentation here.</a>
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> 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.
      operationId: items_batch/post
      x-ratelimit-category: catalogs_write
      x-sandbox: enabled
      security:
      - pinterest_oauth2:
        - catalogs:read
        - catalogs:write
      - client_credentials:
        - catalogs:read
        - catalogs:write
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to create catalogs items in a batch
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/CatalogsVerticalBatchRequest'
              - $ref: '#/components/schemas/CatalogsItemsBatchRequest'
      responses:
        '200':
          description: Response containing the requested catalogs items batch
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsItemsBatch'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: 'Invalid request: {''country'': ''US'', ''language'':
                      ''EN'', ''operation'': ''CREATE'', ''items'': [{''item_id'':
                      ''RAY_01_'', ''attributes'': {''image_link'': ''https://www.example.com/'',
                      ''title'': ''My Product''}}]} (''https://www.example.com/''
                      is not of type array)'
        '401':
          description: Not authenticated to post catalogs items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthenticatedAccess:
                  value:
                    code: 2
                    message: Authentication failed.
        '403':
          description: Not authorized to post catalogs items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_items
  /catalogs/items/batch/{batch_id}:
    get:
      summary: Get item batch status
      description: |-
        Get a single catalogs items batch owned by the "operating user_account". <a href="/docs/api-features/shopping-overview/#Update%20items%20in%20batch" target="_blank">See detailed documentation here.</a>
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.
      operationId: items_batch/get
      security:
      - pinterest_oauth2:
        - catalogs:read
      - client_credentials:
        - catalogs:read
      x-ratelimit-category: catalogs_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_items_batch_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          description: Response containing the requested catalogs items batch
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsItemsBatch'
        '401':
          description: Not authenticated to access catalogs items batch
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthenticatedAccess:
                  value:
                    code: 2
                    message: Authentication failed.
        '403':
          description: Not authorized to access catalogs items batch
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Catalogs items batch not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CannotFindBatch:
                  value:
                    code: 4331
                    message: Sorry! We could not find your batch ID.
        '405':
          description: Method Not Allowed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MethodNotAllowed:
                  value:
                    status: failure
                    code: 5
                    data: '405 Method Not Allowed: The method is not allowed for the
                      requested URL.'
                    message: Method not allowed
                    endpoint_name: null
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_items
  /catalogs/product_groups/multiple:
    delete:
      x-ratelimit-category: catalogs_write
      summary: Delete product groups
      description: |-
        Delete product groups owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: catalogs_product_groups/delete_many
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_catalogs_product_group_ids_required'
      - $ref: '#/components/parameters/query_ad_account_id'
      security:
      - pinterest_oauth2:
        - catalogs:write
      responses:
        '204':
          description: Catalogs Product Groups deleted successfully.
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '403':
          description: Forbidden. Account not approved for catalog product group mutations
            yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '404':
          description: Catalogs product group not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupNotFound:
                  value:
                    code: 4180
                    message: Sorry! We could not find your catalogs product group.
        '409':
          description: Conflict. Can't delete this catalogs product group.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupHasActivePromotions:
                  value:
                    code: 4176
                    message: We can't delete a Catalogs Product Group with active
                      promotions.
                CannotAlterAutoGeneratedCatalogsProductGroup:
                  value:
                    code: 4177
                    message: You cannot alter an auto generated catalogs product group.
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
    post:
      x-ratelimit-category: catalogs_write
      summary: Create product groups
      description: |-
        Create product group to use in Catalogs owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>

        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.
      operationId: catalogs_product_groups/create_many
      security:
      - pinterest_oauth2:
        - catalogs:write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to create one or more catalogs product groups.
        required: true
        content:
          application/json:
            schema:
              type: array
              title: multiple product groups
              items:
                oneOf:
                - $ref: '#/components/schemas/CatalogsProductGroupCreateRequest'
                - $ref: '#/components/schemas/CatalogsVerticalProductGroupCreateRequest'
            examples:
              RetailFewFiltersUsingAllOf:
                summary: A simple retail example that applies "all of the following
                  filters".
                description: |
                  The use of "all_of" creates a Product Group where all of the individual filters
                  must be satisfied by a product to be included in the Product Group.
                value:
                - name: Few Filters using "all_of"
                  feed_id: '2680059592705'
                  filters:
                    all_of:
                    - MIN_PRICE:
                        values: 999.99
                        inclusion: true
                    - CURRENCY:
                        values: USD
                    - CUSTOM_LABEL_0:
                        values:
                        - Luxury Items
              RetailManyFiltersUsingAnyOf:
                summary: A more complete retail example that applies "any of the following
                  filters".
                description: |
                  The use of "any_of" creates a Product Group where any of the individual filters
                  can add products to the Product Group independently.
                value:
                - name: Many Filters using "any_of"
                  feed_id: '2680059592705'
                  filters:
                    all_of:
                    - MIN_PRICE:
                        values: 111.55
                        inclusion: false
                        negated: false
                    - CURRENCY:
                        values: USD
                        negated: false
                    - AVAILABILITY:
                        values:
                        - IN_STOCK
                        - OUT_OF_STOCK
                        - PREORDER
                        negated: false
                    - BRAND:
                        values:
                        - avanti
                        - beautyrest
                        negated: true
                    - GOOGLE_PRODUCT_CATEGORY_0:
                        values:
                        - - furniture
                          - tables
                          - accent tables
                          - end tables
                        - - furniture
                          - chairs
                          - slipper chairs
                        - - home & garden
                        negated: false
                    - CONDITION:
                        values:
                        - NEW
                        - REFURBISHED
                        - USED
                        negated: false
                    - CUSTOM_LABEL_0:
                        values:
                        - 004 - home furn leisure
                        negated: false
                    - CUSTOM_LABEL_1:
                        values:
                        - clearance
                        - original price
                        negated: false
                    - CUSTOM_LABEL_2:
                        values:
                        - 789 - table linens
                        - 794 - living room accents
                        negated: false
                    - GENDER:
                        values:
                        - FEMALE
                        - MALE
                        - UNISEX
                        negated: false
                    - ITEM_ID:
                        values:
                        - does not exists
                        - this one neither
                        - nope
                        negated: true
                    - ITEM_GROUP_ID:
                        values:
                        - nonexistant group
                        - another one
                        - last one
                        negated: true
                    - PRODUCT_TYPE_0:
                        values:
                        - - accent chairs
                          - club chairs
                        - - accent chairs
                          - slipper chairs
                        - - accent tables
                          - end tables
                        - - air mattresses
                          - air mattresses
                        - - table linens
                        negated: false
              CatalogBasedRetailFewFiltersUsingAllOf:
                summary: A simple catalog based retail example that applies "all of
                  the following filters".
                description: |
                  The use of "all_of" creates a Product Group where all of the individual filters
                  must be satisfied by a retail to be included in the Product Group.
                value:
                - catalog_type: RETAIL
                  name: Few Filters using "all_of"
                  catalog_id: '4866935934774'
                  country: US
                  locale: en-US
                  filters:
                    all_of:
                    - ITEM_ID:
                        values:
                        - item1
                        - item2
                    - CUSTOM_LABEL_1:
                        values:
                        - shoes
                        negated: false
              HotelFewFiltersUsingAllOf:
                summary: A simple hotel example that applies "all of the following
                  filters".
                description: |
                  The use of "all_of" creates a Product Group where all of the individual filters
                  must be satisfied by a hotel to be included in the Product Group.
                value:
                - catalog_type: HOTEL
                  name: Few Filters using "all_of"
                  catalog_id: '4866935934774'
                  filters:
                    all_of:
                    - HOTEL_ID:
                        values:
                        - hotel1
                        - hotel2
                    - CUSTOM_LABEL_1:
                        values:
                        - big_hotels
                        negated: false
      responses:
        '201':
          content:
            application/json:
              schema:
                type: array
                items:
                  description: ID of a created catalog product group.
                  example: '443727193917'
                  type: string
                  pattern: ^\d+$
          description: Success
        '400':
          description: Invalid body.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''feed_id'' value ''1511851494501_'' must match the
                      pattern: ^\d+$"}'
                CatalogsProductGroupMissingCountryAndLocale:
                  value:
                    code: 6136
                    message: A catalog product group must have a country and locale
                      specified.
                CatalogsIntlProductGroupCountryOrLocaleSpecified:
                  value:
                    code: 6137
                    message: An international product group cannot have a country
                      or locale specified.
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '403':
          description: Forbidden. Account not approved for catalog product group mutations
            yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '409':
          description: Conflict. Can't create this catalogs product group with this
            value.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupFiltersAlreadyExist:
                  value:
                    code: 4178
                    message: A catalogs product group with these filters already exists
                      for this feed.
                CatalogsProductGroupNameAlreadyExist:
                  value:
                    code: 4179
                    message: A catalogs product group with this name already exists
                      for this feed.
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
                CatalogsProductGroupFiltersInvalid:
                  value:
                    code: 4183
                    message: Catalog product group filters failed validation, please
                      ensure all filters are set correctly.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
  /catalogs/product_groups:
    get:
      x-ratelimit-category: catalogs_read
      summary: List product groups
      description: |-
        Get a list of product groups for a given Catalogs Feed Id owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: catalogs_product_groups/list
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_catalogs_product_group_ids'
      - $ref: '#/components/parameters/query_catalogs_feed_id'
      - $ref: '#/components/parameters/query_catalogs_catalog_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/CatalogsVerticalProductGroup'
          description: Success
        '400':
          description: Invalid feed parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''feed_id'' value ''1511851494501_'' must match the
                      pattern: ^\d+$"}'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '403':
          description: Forbidden. Account not approved for catalog product group mutations
            yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '404':
          description: Data feed not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedNotFound:
                  value:
                    code: 4161
                    message: Sorry! We could not find your catalogs feed.
        '409':
          description: Conflict. Can't create this catalogs product group with this
            value.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
    post:
      x-ratelimit-category: catalogs_write
      summary: Create product group
      description: |-
        Create product group to use in Catalogs owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.
        "Catalog-based product groups" can include items from all data sources (feeds and API) and are available to both non-retail catalogs with any data sources and retail catalogs with API-created items. If your catalog only contains retail items created via feeds, you should use the "retail feed-based" option.
        <a href='/docs/api-features/shopping-overview/'>Learn more</a>

        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.
      operationId: catalogs_product_groups/create
      security:
      - pinterest_oauth2:
        - catalogs:write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to create a single catalogs product groups.
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/CatalogsProductGroupCreateRequest'
              - $ref: '#/components/schemas/CatalogsVerticalProductGroupCreateRequest'
            examples:
              RetailFewFiltersUsingAllOf:
                summary: A simple retail example that applies "all of the following
                  filters".
                description: |
                  The use of "all_of" creates a Product Group where all of the individual filters
                  must be satisfied by a product to be included in the Product Group.
                value:
                  name: Few Filters using "all_of"
                  feed_id: '2680059592705'
                  filters:
                    all_of:
                    - MIN_PRICE:
                        values: 999.99
                        inclusion: true
                    - CURRENCY:
                        values: USD
                    - CUSTOM_LABEL_0:
                        values:
                        - Luxury Items
              RetailManyFiltersUsingAnyOf:
                summary: A more complete retail example that applies "any of the following
                  filters".
                description: |
                  The use of "any_of" creates a Product Group where any of the individual filters
                  can add products to the Product Group independently.
                value:
                  name: Many Filters using "any_of"
                  feed_id: '2680059592705'
                  filters:
                    all_of:
                    - MIN_PRICE:
                        values: 111.55
                        inclusion: false
                        negated: false
                    - CURRENCY:
                        values: USD
                        negated: false
                    - AVAILABILITY:
                        values:
                        - IN_STOCK
                        - OUT_OF_STOCK
                        - PREORDER
                        negated: false
                    - BRAND:
                        values:
                        - avanti
                        - beautyrest
                        negated: true
                    - GOOGLE_PRODUCT_CATEGORY_0:
                        values:
                        - - furniture
                          - tables
                          - accent tables
                          - end tables
                        - - furniture
                          - chairs
                          - slipper chairs
                        - - home & garden
                        negated: false
                    - CONDITION:
                        values:
                        - NEW
                        - REFURBISHED
                        - USED
                        negated: false
                    - CUSTOM_LABEL_0:
                        values:
                        - 004 - home furn leisure
                        negated: false
                    - CUSTOM_LABEL_1:
                        values:
                        - clearance
                        - original price
                        negated: false
                    - CUSTOM_LABEL_2:
                        values:
                        - 789 - table linens
                        - 794 - living room accents
                        negated: false
                    - GENDER:
                        values:
                        - FEMALE
                        - MALE
                        - UNISEX
                        negated: false
                    - ITEM_ID:
                        values:
                        - does not exists
                        - this one neither
                        - nope
                        negated: true
                    - ITEM_GROUP_ID:
                        values:
                        - nonexistant group
                        - another one
                        - last one
                        negated: true
                    - PRODUCT_TYPE_0:
                        values:
                        - - accent chairs
                          - club chairs
                        - - accent chairs
                          - slipper chairs
                        - - accent tables
                          - end tables
                        - - air mattresses
                          - air mattresses
                        - - table linens
                        negated: false
              HotelFewFiltersUsingAllOf:
                summary: A simple hotel example that applies "all of the following
                  filters".
                description: |
                  The use of "all_of" creates a Product Group where all of the individual filters
                  must be satisfied by a hotel to be included in the Product Group.
                value:
                  catalog_type: HOTEL
                  name: Few Filters using "all_of"
                  catalog_id: '4866935934774'
                  filters:
                    all_of:
                    - HOTEL_ID:
                        values:
                        - hotel1
                        - hotel2
                    - CUSTOM_LABEL_1:
                        values:
                        - big_hotels
                        negated: false
              CatalogBasedRetailFewFiltersUsingAllOf:
                summary: A simple catalog based retail example that applies "all of
                  the following filters".
                description: |
                  The use of "all_of" creates a Product Group where all of the individual filters
                  must be satisfied by a retail to be included in the Product Group.
                value:
                  catalog_type: RETAIL
                  name: Few Filters using "all_of"
                  catalog_id: '4866935934774'
                  country: US
                  locale: en-US
                  filters:
                    all_of:
                    - ITEM_ID:
                        values:
                        - item1
                        - item2
                    - CUSTOM_LABEL_1:
                        values:
                        - shoes
                        negated: false
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsVerticalProductGroup'
          description: Success
        '400':
          description: Invalid body.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''feed_id'' value ''1511851494501_'' must match the
                      pattern: ^\d+$"}'
                CatalogsProductGroupMissingCountryAndLocale:
                  value:
                    code: 6136
                    message: A catalog product group must have a country and locale
                      specified.
                CatalogsIntlProductGroupCountryOrLocaleSpecified:
                  value:
                    code: 6137
                    message: An international product group cannot have a country
                      or locale specified.
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '403':
          description: Forbidden. Account not approved for catalog product group mutations
            yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '409':
          description: Conflict. Can't create this catalogs product group with this
            value.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupFiltersAlreadyExist:
                  value:
                    code: 4178
                    message: A catalogs product group with these filters already exists
                      for this feed.
                CatalogsProductGroupNameAlreadyExist:
                  value:
                    code: 4179
                    message: A catalogs product group with this name already exists
                      for this feed.
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
                CatalogsProductGroupFiltersInvalid:
                  value:
                    code: 4183
                    message: Catalog product group filters failed validation, please
                      ensure all filters are set correctly.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
  /catalogs/product_groups/{product_group_id}:
    get:
      x-ratelimit-category: catalogs_read
      summary: Get product group
      description: |-
        Get a singe product group for a given Catalogs Product Group Id owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: catalogs_product_groups/get
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_product_group_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      security:
      - pinterest_oauth2:
        - catalogs:read
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsVerticalProductGroup'
          description: Success
        '400':
          description: Invalid catalogs product group id parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''product_group_id'' value ''11851494501_'' must match
                      the pattern: ^\d+$"}'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '403':
          description: Forbidden. Account not approved for catalog product group mutations
            yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '404':
          description: Catalogs product group not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupNotFound:
                  value:
                    code: 4180
                    message: Sorry! We could not find your catalogs product group.
        '409':
          description: Conflict. Can't get a catalogs product group without an existing
            catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't acccess this feature without an existing catalog.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
    delete:
      x-ratelimit-category: catalogs_write
      summary: Delete product group
      description: |-
        Delete a product group owned by the "operation user_account" from being in use in Catalogs.
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: catalogs_product_groups/delete
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_product_group_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      security:
      - pinterest_oauth2:
        - catalogs:write
      responses:
        '204':
          description: Catalogs Product Group deleted successfully.
        '400':
          description: Invalid catalogs product group id parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''product_group_id'' value ''11851494501_'' must match
                      the pattern: ^\d+$"}'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '403':
          description: Forbidden. Account not approved for catalog product group mutations
            yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '404':
          description: Catalogs product group not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupNotFound:
                  value:
                    code: 4180
                    message: Sorry! We could not find your catalogs product group.
        '409':
          description: Conflict. Can't delete this catalogs product group.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupHasActivePromotions:
                  value:
                    code: 4176
                    message: We can't delete a Catalogs Product Group with active
                      promotions.
                CannotAlterAutoGeneratedCatalogsProductGroup:
                  value:
                    code: 4177
                    message: You cannot alter an auto generated catalogs product group.
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
    patch:
      x-ratelimit-category: catalogs_write
      summary: Update single product group
      description: |-
        Update product group owned by the "operation user_account" to use in Catalogs.
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.
        "Catalog-based product groups" can include items from all data sources (feeds and API) and are available to both non-retail catalogs with any data sources and retail catalogs with API-created items. If your catalog only contains retail items created via feeds, you should use the "retail feed-based" option.
        <a href='/docs/api-features/shopping-overview/'>Learn more</a>

        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.
      operationId: catalogs_product_groups/update
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_product_group_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      security:
      - pinterest_oauth2:
        - catalogs:write
      requestBody:
        description: Request object used to Update a catalogs product group.
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/CatalogsProductGroupUpdateRequest'
              - $ref: '#/components/schemas/CatalogsVerticalProductGroupUpdateRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsVerticalProductGroup'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''product_group_id'' value ''11851494501_'' must match
                      the pattern: ^\d+$"}'
                CatalogsIntlProductGroupCountryOrLocaleSpecified:
                  value:
                    code: 6137
                    message: An international product group cannot have a country
                      or locale specified.
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '403':
          description: Forbidden. Account not approved for catalog product group mutations
            yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                MerchantDisapproved:
                  value:
                    code: 2625
                    message: Sorry, you cannot perform this action as your account
                      has been disapproved. Please see business hub for more details.
                      https://www.pinterest.com/business/hub/
                MerchantUnderReview:
                  value:
                    code: 2626
                    message: We are reviewing your account. Please see business hub
                      for more details. https://www.pinterest.com/business/hub/
        '404':
          description: Catalogs product group not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupNotFound:
                  value:
                    code: 4180
                    message: Sorry! We could not find your catalogs product group.
        '409':
          description: Conflict. Can't update this catalogs product group to this
            value.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CannotAlterAutoGeneratedCatalogsProductGroup:
                  value:
                    code: 4177
                    message: You cannot alter an auto generated catalogs product group.
                CatalogsProductGroupFiltersAlreadyExist:
                  value:
                    code: 4178
                    message: A catalogs product group with these filters already exists
                      for this feed.
                CatalogsProductGroupNameAlreadyExist:
                  value:
                    code: 4179
                    message: A catalogs product group with this name already exists
                      for this feed.
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
                CatalogsProductGroupFiltersInvalid:
                  value:
                    code: 4183
                    message: Catalog product group filters failed validation, please
                      ensure all filters are set correctly.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
  /catalogs/product_groups/{product_group_id}/product_counts:
    get:
      x-ratelimit-category: catalogs_read
      summary: Get product counts
      description: |-
        Get a product counts for a given Catalogs Product Group owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: catalogs_product_groups/product_counts_get
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_product_group_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsProductGroupProductCountsVertical'
          description: Success
        '404':
          description: Product Group Not Found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupNotFound:
                  value:
                    code: 4180
                    message: Sorry! We could not find your catalogs product group.
        '409':
          description: Can't access this feature without an existing catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
  /catalogs/product_groups/{product_group_id}/products:
    get:
      x-ratelimit-category: catalogs_read
      summary: List products by product group
      description: |-
        Get a list of product pins for a given Catalogs Product Group Id owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: catalogs_product_group_pins/list
      security:
      - pinterest_oauth2:
        - boards:read
        - catalogs:read
        - pins:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/path_catalogs_product_group_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_pin_metrics'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Pins
                      items:
                        $ref: '#/components/schemas/CatalogsProduct'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: '''product_group_id'' value ''11851494501_'' must match
                      the pattern: ^\d+$"}'
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '404':
          description: Catalogs product group not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsProductGroupNotFound:
                  value:
                    code: 4180
                    message: Sorry! We could not find your catalogs product group.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
  /catalogs/products/get_by_product_group_filters:
    post:
      x-ratelimit-category: catalogs_read
      summary: List products by filter
      description: |-
        List products Pins owned by the "operation user_account" that meet the criteria specified in the Catalogs Product Group Filter given in the request.
        - This endpoint has been implemented in POST to allow for complex filters. This specific POST endpoint is designed to be idempotent.
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        Note: This endpoint only supports RETAIL catalog at the moment.

        <a href='/docs/api-features/shopping-overview/'>Learn more</a>
      operationId: products_by_product_group_filter/list
      security:
      - pinterest_oauth2:
        - boards:read
        - catalogs:read
        - pins:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_pin_metrics'
      requestBody:
        description: Object holding a group of filters for a catalog product group
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CatalogsListProductsByFilterRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Pins
                      items:
                        $ref: '#/components/schemas/CatalogsProduct'
          description: Success
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '409':
          description: Conflict. Can't get products.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't acccess this feature without an existing catalog.
                CatalogsProductGroupFiltersInvalid:
                  value:
                    code: 4183
                    message: Catalog product group filters failed validation, please
                      ensure all filters are set correctly.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_product_groups
  /catalogs/reports:
    post:
      summary: Build catalogs report
      description: |-
        Async request to create a report of the catalog owned by the "operation user_account". This endpoint generates a report upon receiving the first approved request of the day. Any following requests with identical parameters will yield the same report even if data has changed.
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.

        Note: Access to the All Items report type is restricted to a specific group of users.
        If you require access, please reach out to your partner manager.
      operationId: reports/create
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-ratelimit-category: catalogs_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object to asynchronously create a report.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CatalogsReportParameters'
      responses:
        '200':
          description: Response containing the report token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsCreateReportResponse'
        '404':
          description: Entity (e.g., catalog, feed or processing_result) not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogNotFound:
                  value:
                    code: 678
                    message: Sorry! We couldn't find that catalog. Please ensure you
                      have access to a valid catalog id.
                FeedNotFound:
                  value:
                    code: 4161
                    message: Sorry! We could not find your catalogs feed.
                CatalogsProcessingResultNotFound:
                  value:
                    code: 4184
                    message: Sorry! We could not find your processing result
        '409':
          description: Can't access this feature without an existing catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_reports
    get:
      summary: Get catalogs report
      description: |-
        This returns a URL to a report given a token returned from <a href='/docs/api/v5/#operation/reports/create'>Build catalogs report</a>. You can use the URL to download the report.
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.
      operationId: reports/get
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-ratelimit-category: catalogs_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_catalogs_report_token'
      responses:
        '200':
          description: Response that contains a link to download the report
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsReport'
        '400':
          description: The token you provided is not valid or has expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidReportingToken:
                  value:
                    code: 1104
                    message: The token you provided is not valid or has expired.
        '409':
          description: Can't access this feature without an existing catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CatalogsMerchantNotCreated:
                  value:
                    code: 4182
                    message: Can't access this feature without an existing catalog.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_reports
  /catalogs/reports/stats:
    get:
      summary: List report stats
      description: |-
        List aggregated numbers of issues for a catalog owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.
      operationId: reports/stats
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-ratelimit-category: catalogs_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_catalogs_report_stats_parameters'
      responses:
        '200':
          description: Response containing the diagnostics aggregated counters
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/CatalogsReportStats'
        '401':
          description: Not authorized to access catalogs
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 2
                    message: Authentication failed.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - catalog_reports
  /integrations/commerce:
    post:
      summary: Create commerce integration
      description: |-
        Create commerce integration metadata to link an external business ID with a Pinterest merchant & ad account.
        Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
      operationId: integrations_commerce/post
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IntegrationRequest'
        description: Parameters to get create/update the Integration Metadata
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationMetadata'
          description: Success
        '404':
          description: Integration not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                IntegrationNotFound:
                  value:
                    code: 4180
                    message: Sorry! We could not find your integration.
        '409':
          description: Can't access this integration metadata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NotIntegrationOwner:
                  value:
                    code: 4182
                    message: Can't access this integration metadata.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - integrations
  /integrations/commerce/{external_business_id}:
    get:
      summary: Get commerce integration
      description: |-
        Get commerce integration metadata associated with the given external business ID.
        Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
      operationId: integrations_commerce/get
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_external_business_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationMetadata'
          description: Success
        '404':
          description: Integration not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                IntegrationNotFound:
                  value:
                    code: 4180
                    message: Sorry! We could not find your integration.
        '409':
          description: Can't access this integration metadata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NotIntegrationOwner:
                  value:
                    code: 4182
                    message: Can't access this integration metadata.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - integrations
    patch:
      summary: Update commerce integration
      description: |-
        Update commerce integration metadata for the given external business ID.
        Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
      operationId: integrations_commerce/patch
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_external_business_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IntegrationRequestPatch'
        description: Parameters to get create/update the Integration Metadata
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationMetadata'
          description: Success
        '404':
          description: Integration not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                IntegrationNotFound:
                  value:
                    code: 4180
                    message: Sorry! We could not find your integration.
        '409':
          description: Can't access this integration metadata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NotIntegrationOwner:
                  value:
                    code: 4182
                    message: Can't access this integration metadata.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - integrations
    delete:
      summary: Delete commerce integration
      description: |-
        Delete commerce integration metadata for the given external business ID.
        Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
      operationId: integrations_commerce/del
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_external_business_id'
      responses:
        '204':
          description: Commerce Integration deleted successfully
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - integrations
  /integrations/logs:
    post:
      summary: Receives batched logs from integration applications.
      description: |-
        This endpoint receives batched logs from integration applications on partner platforms.
        Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
      tags:
      - integrations
      operationId: integrations_logs/post
      x-ratelimit-category: ads_write
      security:
      - pinterest_oauth2:
        - ads:write
      x-sandbox: enabled
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IntegrationLogsRequest'
        description: Ingest log information from external integration application.
        required: true
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationLogsSuccessResponse'
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/Error'
                - $ref: '#/components/schemas/DetailedError'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /integrations:
    get:
      summary: Get integration metadata list
      description: |-
        Get integration metadata list.
        Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
      operationId: integrations/get_list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/IntegrationRecord'
          description: Success
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - integrations
  /integrations/{id}:
    get:
      summary: Get integration metadata
      description: |-
        Get integration metadata by ID.
        Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.
      operationId: integrations/get_by_id
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - name: id
        description: Integration ID.
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationRecord'
          description: Success
        '404':
          description: Integration not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                IntegrationNotFound:
                  value:
                    code: 4517
                    message: Sorry! We could not find your integration.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - integrations
  /media:
    get:
      summary: List media uploads
      description: |-
        List media uploads filtered by given parameters.

        <strong><a href='/docs/api-features/creating-boards-and-pins/#creating-video-pins'>Learn more</a></strong> about video Pin creation.
      tags:
      - media
      operationId: media/list
      security:
      - pinterest_oauth2:
        - pins:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Media
                      items:
                        $ref: '#/components/schemas/MediaUploadDetails'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    post:
      summary: Register media upload
      description: |-
        Register your intent to upload media

        The response includes all of the information needed to upload the media
        to Pinterest.

        To upload the media, make an HTTP POST request (using <tt>curl</tt>, for
        example) to <tt>upload_url</tt> using the <tt>Content-Type</tt> header
        value. Send the media file's contents as the request's <tt>file</tt>
        parameter and also include all of the parameters from
        <tt>upload_parameters</tt>.

        <strong><a href='/docs/api-features/creating-boards-and-pins/#creating-video-pins'>Learn more</a></strong> about video Pin creation.
      tags:
      - media
      operationId: media/create
      security:
      - pinterest_oauth2:
        - pins:read
        - pins:write
      x-ratelimit-category: org_write
      x-sandbox: enabled
      requestBody:
        description: Create a media upload request
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MediaUploadRequest'
      responses:
        '201':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaUpload'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /media/{media_id}:
    get:
      summary: Get media upload details
      description: |-
        Get details for a registered media upload, including its current status.

        <strong><a href='/docs/api-features/creating-boards-and-pins/#creating-video-pins'>Learn more</a></strong> about video Pin creation.
      tags:
      - media
      operationId: media/get
      security:
      - pinterest_oauth2:
        - pins:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_media_id'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaUploadDetails'
        '404':
          description: Media upload not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: Media upload not found
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /notifications:
    post:
      summary: Receive notifications from external partners.
      description: Used by third-party partners to send notifications to Pinterest.
        These notifications could be specific for your use-case or generic notification
        that are accepted by Pinterests' systems. This API is gated and you need to
        request access to this feature.
      operationId: notification/post
      security:
      - pinterest_oauth2:
        - user_accounts:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      requestBody:
        description: notification event.
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - type: array
                minItems: 1
                maxItems: 100
                items:
                  type: object
                  additionalProperties: true
                  description: Any valid JSON object
              - type: object
              additionalProperties: true
              description: Any valid JSON object
      responses:
        '200':
          content:
            application/json:
              schema:
                title: NotificationResponse
                type: object
                properties:
                  success:
                    description: Returns true if the notification accepted.
                    type: boolean
                    example: false
                  received_at:
                    description: Received time. Unix timestamp in seconds.
                    example: 1677003860
                    type: integer
                  error_msg:
                    type: string
                    description: error message when success is false
          description: Successfully received notification
        '400':
          description: Invalid request parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 6126
                message: Invalid request parameter.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - notification
  /oauth/token:
    post:
      summary: Generate OAuth access token
      description: |-
        Generate an OAuth access token by using an authorization code or a refresh token.

        IMPORTANT: You need to start the OAuth flow via www.pinterest.com/oauth before calling this endpoint (or have an existing refresh token).

        See <a href='/docs/getting-started/authentication-and-scopes/'>Authentication</a> for more.

        <strong>Parameter <i>refresh_on</i> and its corresponding response type <i>everlasting_refresh</i> are now available to all apps! Later this year, continuous refresh will become the default behavior (ie you will no longer need to send this parameter). <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>

        <strong>Use <a href='/tools/debug-token/'>Token Debugger</a> to validate and inspect your access token.</strong>
      tags:
      - oauth
      operationId: oauth/token
      security:
      - basic: []
      x-ratelimit-category: org_read
      x-sandbox: enabled
      requestBody:
        description: Generate an OAuth access token.
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/OauthAccessTokenRequest'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OauthAccessTokenResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /oauth/token/revoke:
    post:
      summary: Revoke a token
      description: Revokes an access or refresh token. Only tokens issued for system
        users are currently supported. Revoked tokens become immediately invalid and
        unusable.
      tags:
      - oauth
      operationId: token/revoke
      security:
      - basic: []
      x-ratelimit-category: org_write
      x-sandbox: enabled
      requestBody:
        description: Body containing the token to revoke.
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/TokenRevocationRequest'
      responses:
        '200':
          description: Successful token revocation. No content is returned.
        '401':
          description: Client authentication error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 2
                message: Authentication failed.
        '403':
          description: Client is not allowed to revoke token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 29
                message: You are not permitted to access that resource.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /pins:
    post:
      operationId: pins/create
      summary: Create Pin
      description: |2-
         Create a Pin on a board or board section owned by the "operation user_account".

         Note: If the current "operation user_account" (defined by the access token) has access to another user's Ad Accounts via Pinterest Business Access, you can modify your request to make use of the current operation_user_account's permissions to those Ad Accounts by including the ad_account_id in the path parameters for the request (e.g. .../?ad_account_id=12345&...).

        - This function is intended solely for publishing new content created by the user. If you are interested in saving content created by others to your Pinterest boards, sometimes called 'curated content', please use our [Save button](/docs/web-features/add-ons-overview/) instead. For more tips on creating fresh content for Pinterest, review our [Content App Solutions Guide](/docs/api-features/content-overview/).

        **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-video-pins)** about video Pin creation.

        **[Learn more](/docs/api-features/creating-boards-and-pins/#creating-image-pins)** about image Pin creation.
      parameters:
      - $ref: '#/components/parameters/QueryParams.query_ad_account_id'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pin'
        '201':
          description: Resource create operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pin'
        '400':
          description: The request could not be understood by the server due to unexpected
            data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '401':
          description: Authentication is required and has either failed or not been
            provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '403':
          description: The request was valid, but the server is refusing action. The
            user might not have the necessary permissions for a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '404':
          description: The requested resource could not be found on this server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '429':
          description: The user has sent too many requests in a given amount of time
            and is being rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
      tags:
      - pins
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PinCreate'
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
        - pins:read
        - pins:write
      - client_credentials:
        - boards:read
        - boards:write
        - pins:read
        - pins:write
      x-sandbox: enabled
      x-ratelimit-category: org_write
    get:
      operationId: pins/list
      summary: List Pins
      description: |2-
            Get a list of the Pins owned by the "operation user_account".
            - By default, the "operation user_account" is the token user_account.
            - All Pins owned by the "operation user_account" are included, regardless of who owns the board they are on.

            Optional: Business Access: Specify an `ad_account_id` to use the owner of that ad_account as the "operation user_account".

            Disclaimer: There are known performance issues when filtering by field `creative_type` and including protected pins.
            If your request is timing out in this scenario, we encourage you to use [GET List Pins on Board](/docs/api/v5/#operation/boards/list_pins).
      parameters:
      - $ref: '#/components/parameters/QueryParams.query_pin_filter'
      - $ref: '#/components/parameters/QueryParams.query_pin_metrics'
      - $ref: '#/components/parameters/QueryParams.query_include_protected_pins'
      - $ref: '#/components/parameters/QueryParams.query_pin_type'
      - $ref: '#/components/parameters/QueryParams.query_creative_types'
      - $ref: '#/components/parameters/QueryParams.query_ad_account_id'
      - $ref: '#/components/parameters/Pinterest.Lib.BookmarkParams.bookmark'
      - $ref: '#/components/parameters/Pinterest.Lib.BookmarkParams.page_size'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: object
                required:
                - items
                properties:
                  bookmark:
                    type: string
                    nullable: true
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Pin'
        '400':
          description: The request could not be understood by the server due to unexpected
            data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '401':
          description: Authentication is required and has either failed or not been
            provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '403':
          description: The request was valid, but the server is refusing action. The
            user might not have the necessary permissions for a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '404':
          description: The requested resource could not be found on this server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '429':
          description: The user has sent too many requests in a given amount of time
            and is being rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
      tags:
      - pins
      security:
      - pinterest_oauth2:
        - boards:read
        - pins:read
      - client_credentials:
        - boards:read
        - pins:read
      x-sandbox: enabled
      x-ratelimit-category: org_read
  /pins/{pin_id}:
    get:
      operationId: pins/get
      summary: Get Pin
      description: |2-
          Get a Pin owned by the "operation user_account" - or on a group board that has been shared with this account.
          - 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:

          - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.
          - For Pins on secret boards: Owner, Admin.
      parameters:
      - $ref: '#/components/parameters/PinKey'
      - $ref: '#/components/parameters/QueryParams.query_ad_account_id'
      - $ref: '#/components/parameters/QueryParams.query_pin_metrics'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pin'
        '400':
          description: The request could not be understood by the server due to unexpected
            data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '401':
          description: Authentication is required and has either failed or not been
            provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '403':
          description: The request was valid, but the server is refusing action. The
            user might not have the necessary permissions for a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '404':
          description: The requested resource could not be found on this server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '429':
          description: The user has sent too many requests in a given amount of time
            and is being rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
      tags:
      - pins
      security:
      - pinterest_oauth2:
        - boards:read
        - pins:read
      - client_credentials:
        - boards:read
        - pins:read
      x-sandbox: enabled
      x-ratelimit-category: org_read
    patch:
      operationId: pins/update
      summary: Update Pin
      description: |-
        Update a pin owned by the "operating user_account".
        - 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:

        - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.
        - For Pins on secret boards: Owner, Admin.

        **This endpoint is currently in beta and not available to all apps. [Learn more](/docs/getting-started/using-beta-and-restricted-features/).**
      parameters:
      - $ref: '#/components/parameters/PinKey'
      - $ref: '#/components/parameters/QueryParams.query_ad_account_id'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pin'
        '400':
          description: The request could not be understood by the server due to unexpected
            data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '401':
          description: Authentication is required and has either failed or not been
            provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '403':
          description: The request was valid, but the server is refusing action. The
            user might not have the necessary permissions for a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '404':
          description: The requested resource could not be found on this server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '429':
          description: The user has sent too many requests in a given amount of time
            and is being rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
      tags:
      - pins
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PinUpdate'
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
        - pins:read
        - pins:write
      - client_credentials:
        - boards:read
        - boards:write
        - pins:read
        - pins:write
      x-sandbox: enabled
      x-ratelimit-category: org_write
    delete:
      operationId: pins/delete
      summary: Delete Pin
      description: |2-
          Delete a Pins owned by the "operation user_account" - or on a group board that has been shared with this account.
          - 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:

          - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.
          - For Pins on secret boards: Owner, Admin.
      parameters:
      - $ref: '#/components/parameters/PinKey'
      - $ref: '#/components/parameters/QueryParams.query_ad_account_id'
      responses:
        '204':
          description: Resource deleted successfully.
        '400':
          description: The request could not be understood by the server due to unexpected
            data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '401':
          description: Authentication is required and has either failed or not been
            provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '403':
          description: The request was valid, but the server is refusing action. The
            user might not have the necessary permissions for a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '404':
          description: The requested resource could not be found on this server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        '429':
          description: The user has sent too many requests in a given amount of time
            and is being rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pinterest.Lib.Error'
      tags:
      - pins
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
        - pins:read
        - pins:write
      - client_credentials:
        - boards:read
        - boards:write
        - pins:read
        - pins:write
      x-sandbox: enabled
      x-ratelimit-category: org_write
  /pins/{pin_id}/analytics:
    get:
      summary: Get Pin analytics
      description: |-
        Get analytics for a Pin owned by the "operation user_account" - or on a group board that has been shared with this account.
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href="/docs/api/v5/#operation/ad_accounts/list">List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account:

        - For Pins on public or protected boards: Admin, Analyst.
        - For Pins on secret boards: Admin.

        If Pin was created before <code>2023-03-20</code> lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
      tags:
      - pins
      operationId: pins/analytics
      security:
      - pinterest_oauth2:
        - boards:read
        - pins:read
      - client_credentials:
        - boards:read
        - pins:read
      x-ratelimit-category: org_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_pin_id'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_app_types'
      - $ref: '#/components/parameters/query_pin_analytics_metric_types'
      - $ref: '#/components/parameters/query_split_field_pins'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PinAnalyticsResponse'
        '400':
          description: Invalid pins analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid pins analytics parameters.
        '403':
          description: Not authorized to access board or Pin.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to access board or Pin.
        '404':
          description: Pin not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: Pin not found.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /pins/analytics:
    get:
      summary: Get multiple Pin analytics
      description: |-
        <strong>This endpoint is currently in beta and not available to all apps. <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>

        Get analytics for multiple pins owned by the "operation user_account" - or on a group board that has been shared with this account.
        - The maximum number of pins supported in a single request is 100.
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href="/docs/api/v5/#operation/ad_accounts/list">List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account:

        - For Pins on public or protected boards: Admin, Analyst.
        - For Pins on secret boards: Admin.

        If Pin was created before <code>2023-03-20</code> lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
      tags:
      - pins
      operationId: multi_pins/analytics
      security:
      - pinterest_oauth2:
        - boards:read
        - pins:read
      - client_credentials:
        - boards:read
        - pins:read
      x-ratelimit-category: org_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_required_pin_ids'
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_app_types'
      - description: Pin metric types to get data for.
        explode: false
        in: query
        name: metric_types
        required: true
        schema:
          type: array
          items:
            oneOf:
            - description: Standard Pin metric types
              type: string
              enum:
              - IMPRESSION
              - OUTBOUND_CLICK
              - PIN_CLICK
              - SAVE
              - SAVE_RATE
              - TOTAL_COMMENTS
              - TOTAL_REACTIONS
              - USER_FOLLOW
              - PROFILE_VISIT
            - description: Video Pin metric types
              type: string
              enum:
              - IMPRESSION
              - OUTBOUND_CLICK
              - PIN_CLICK
              - SAVE
              - SAVE_RATE
              - VIDEO_MRC_VIEW
              - VIDEO_10S_VIEW
              - QUARTILE_95_PERCENT_VIEW
              - VIDEO_V50_WATCH_TIME
              - VIDEO_START
              - VIDEO_AVG_WATCH_TIME
              - TOTAL_COMMENTS
              - TOTAL_REACTIONS
        style: form
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkPinAnalyticsResponse'
        '400':
          description: Invalid pins analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 1
                message: Invalid multi_pins analytics parameters.
        '401':
          description: Not authorized to access board or Pin.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 7
                message: Not authorized to access board or Pin.
        '404':
          description: Pin not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 50
                message: Pin not found.
        '429':
          description: |-
            This request exceeded a rate limit. This can happen if the client exceeds one
            of the published rate limits or if multiple write operations are applied to
            an object within a short time window.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 8
                message: |-
                  This request exceeded a rate limit. This can happen if the client exceeds one
                  of the published rate limits or if multiple write operations are applied to
                  an object within a short time window.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /pins/{pin_id}/save:
    post:
      summary: Save Pin
      description: |-
        Save a Pin on a board or board section owned by the "operation user_account".
        - By default, the "operation user_account" is the token user_account.
        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href='/docs/api/v5/#operation/ad_accounts/list'>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account:

        - For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.
        - For Pins on secret boards: Owner, Admin.

        - Any Pin type can be saved: image Pin, video Pin, Idea Pin, product Pin, etc.
        - Any public Pin can be saved given a pin ID.
      tags:
      - pins
      operationId: pins/save
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:write
        - pins:read
        - pins:write
      x-ratelimit-category: org_write
      x-sandbox: enabled
      x-codeSamples:
      - lang: python
        label: Python SDK
        source: |
          # Follow this link for initial setup: https://github.com/pinterest/pinterest-python-sdk#getting-started

          from pinterest.organic.pins import Pin
          # Pin information can be fetched from profile page or from create/list pin method here:
          # /docs/api/v5/#operation/pins/list
          PIN_ID="<Add your pin id here>"

          # Board information can be fetched from profile page or from list board method here:
          # /docs/api/v5/#operation/boards/list
          NEW_BOARD_ID="<Add your board id here>"

          pin_save = Pin(pin_id=PIN_ID)
          pin_save.save(board_id=NEW_BOARD_ID)
          print("Pin Id: %s, Board Id:%s" %(pin_save.id, pin_save.board_id))
      - lang: cURL
        label: curl
        source: |
          # Pin and Board information can be fetched from profile page or from create/list pin method here:
          # /docs/api/v5/#operation/pins/list
          # /docs/api/v5/#operation/boards/list

          curl --request DELETE 'https://api.pinterest.com/v5/pins/<insert_pin_id>/save' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json' \
          --data-raw '{
              "board_id": <insert_new_board_id>
          }'
      - lang: cURL
        label: curl (Sandbox)
        source: |
          # Pin and Board information can be fetched from profile page or from create/list pin method here:
          # /docs/api/v5/#operation/pins/list
          # /docs/api/v5/#operation/boards/list

          curl --request DELETE 'https://api-sandbox.pinterest.com/v5/pins/<insert_sandbox_pin_id>/save' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json' \
          --data-raw '{
              "board_id": <insert_new_sandbox_board_id>
          }'
      parameters:
      - $ref: '#/components/parameters/path_pin_id'
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Request object used to save an existing pin
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                board_id:
                  description: Unique identifier of the board to which the pin will
                    be saved.
                  type: string
                  pattern: ^\d+$
                  nullable: true
                board_section_id:
                  description: Unique identifier of the board section to which the
                    pin will be saved.
                  type: string
                  pattern: ^\d+$
                  nullable: true
      responses:
        '201':
          description: Successfully saved pin.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pin'
        '403':
          description: Not authorized to access Board or Pin.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 29
                message: You are not permitted to access that resource.
        '404':
          description: Board or Pin not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                BoardNotFound:
                  value:
                    code: 40
                    message: Board not found.
                PinNotFound:
                  value:
                    code: 50
                    message: Pin not found.
                BoardSectionNotFound:
                  value:
                    code: 2031
                    message: Sorry! We couldn't find this board section.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /resources/ad_account_countries:
    get:
      summary: Get ad accounts countries
      description: Get Ad Accounts countries
      operationId: ad_account_countries/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdAccountsCountryResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - resources
  /resources/delivery_metrics:
    get:
      summary: Get available metrics' definitions
      description: |-
        Get the definitions for ads and organic metrics available across both synchronous and asynchronous report endpoints.
        The `display_name` attribute will match how the metric is named in our native tools like Ads Manager.
        See <a href='/docs/api-features/analytics-overview/'>Organic Analytics</a> and <a href='/docs/api-features/ads-reporting/'>Ads Analytics</a> for more information.
      operationId: delivery_metrics/get
      security:
      - pinterest_oauth2:
        - ads:read
        - pins:read
        - user_accounts:read
      - client_credentials:
        - ads:read
        - pins:read
        - user_accounts:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_report_type'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeliveryMetricsResponse'
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - resources
  /resources/lead_form_questions:
    get:
      summary: Get lead form questions
      description: |-
        Get a list of all lead form question type names. Some questions might not be used.

        <strong>This endpoint is currently in beta and not available to all apps. <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>
      operationId: lead_form_questions/get
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      responses:
        '200':
          description: Success
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - resources
  /resources/metrics_ready_state:
    get:
      summary: Get metrics ready state
      description: Learn whether conversion or non-conversion metrics are finalized
        and ready to query.
      operationId: metrics_ready_state/get
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: enabled
      parameters:
      - name: date
        description: 'Analytics reports request date (UTC). Format: YYYY-MM-DD'
        in: query
        required: true
        style: form
        schema:
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
          example: '2022-07-13'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BookClosedResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - resources
  /resources/targeting/interests/{interest_id}:
    get:
      summary: Get interest details
      description: <p>Get details of a specific interest given interest ID.</p> <p>Click
        <a href="https://docs.google.com/spreadsheets/d/1HxL-0Z3p2fgxis9YBP2HWC3tvPrs1hAuHDRtH-NJTIM/edit#gid=118370875"
        target="_blank">here</a> for a spreadsheet listing interests and their IDs.</p>
      operationId: interest_targeting_options/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_interest_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SingleInterestTargetingOptionResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - resources
  /resources/targeting/{targeting_type}:
    get:
      summary: Get targeting options
      description: |-
        <p>You can use targeting values in ads placement to define your intended audience. </p> <p>Targeting metrics are organized around targeting specifications.</p> <p>For more information on ads targeting, see <a class="reference external" href="https://help.pinterest.com/en/business/article/audience-targeting" target="_blank">Audience targeting</a>.</p>
        <p><b>Sample return:</b></p> <pre class="literal-block"> [{&quot;36313&quot;: &quot;Australia: Moreton Bay - North&quot;, &quot;124735&quot;: &quot;Canada: North Battleford&quot;, &quot;36109&quot;: &quot;Australia: Murray&quot;, &quot;36108&quot;: &quot;Australia: Mid North Coast&quot;, &quot;36101&quot;: &quot;Australia: Capital Region&quot;, &quot;811&quot;: &quot;U.S.: Reno&quot;, &quot;36103&quot;: &quot;Australia: Central West&quot;, &quot;36102&quot;: &quot;Australia: Central Coast&quot;, &quot;36105&quot;: &quot;Australia: Far West and Orana&quot;, &quot;36104&quot;: &quot;Australia: Coffs Harbour - Grafton&quot;, &quot;36107&quot;: &quot;Australia: Illawarra&quot;, &quot;36106&quot;: &quot;Australia: Hunter Valley Exc Newcastle&quot;, &quot;554017&quot;: &quot;New Zealand: Wanganui&quot;, &quot;554016&quot;: &quot;New Zealand: Marlborough&quot;, &quot;554015&quot;: &quot;New Zealand: Gisborne&quot;, &quot;554014&quot;: &quot;New Zealand: Tararua&quot;, &quot;554013&quot;: &quot;New Zealand: Invercargill&quot;, &quot;GR&quot;: &quot;Greece&quot;, &quot;554011&quot;: &quot;New Zealand: Whangarei&quot;, &quot;554010&quot;: &quot;New Zealand: Far North&quot;, &quot;717&quot;: &quot;U.S.: Quincy-Hannibal-Keokuk&quot;, &quot;716&quot;: &quot;U.S.: Baton Rouge&quot;,...}] </pre>
      operationId: targeting_options/get
      security:
      - pinterest_oauth2:
        - ads:read
      - client_credentials:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_targeting_type'
      - $ref: '#/components/parameters/query_client_id'
      - $ref: '#/components/parameters/query_oauth_signature'
      - $ref: '#/components/parameters/query_timestamp'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TargetingOptionResponse'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - resources
  /search/boards:
    get:
      summary: Search user's boards
      description: |-
        Search for boards for the "operation user_account". This includes boards of all board types.
        - By default, the "operation user_account" is the token user_account.

        If using Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account". See <a href='/docs/getting-started/using-business-access/'>Understanding Business Access</a> for more information.
      operationId: search_user_boards/get
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:read_secret
      - client_credentials:
        - boards:read
        - boards:read_secret
      x-ratelimit-category: org_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_query'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: items
                      items:
                        $ref: '#/components/schemas/Board'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - search
  /search/pins:
    get:
      description: |-
        Search for pins for the "operation user_account".
        - By default, the "operation user_account" is the token user_account.

        If using Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account". See <a href='/docs/getting-started/using-business-access/'>Understanding Business Access</a> for more information.
      operationId: search_user_pins/list
      security:
      - pinterest_oauth2:
        - boards:read
        - boards:read_secret
        - pins:read
        - pins:read_secret
      x-ratelimit-category: org_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      - $ref: '#/components/parameters/query_required_search_query'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Pin'
          description: Success
        '404':
          description: User not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UserNotFound:
                  value:
                    code: 30
                    message: User not found.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      summary: Search user's Pins
      tags:
      - search
  /search/partner/pins:
    get:
      summary: Search pins by a given search term
      description: |-
        <strong>This endpoint is currently in beta and not available to all apps. <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>

        Get the top 10 Pins by a given search term.
      operationId: search_partner_pins
      security:
      - pinterest_oauth2:
        - boards:read
        - pins:read
      x-ratelimit-category: org_read
      x-sandbox: disabled
      x-codeSamples:
      - lang: cURL
        label: curl
        source: |
          curl --location --request GET 'https://api.pinterest.com/v5/search/partner/pins' \
          --header 'Authorization: Bearer <Add your token here>' \
          --header 'Content-Type: application/json'
      parameters:
      - description: Search term to look up pins.
        in: query
        name: term
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/query_country_code'
      - $ref: '#/components/parameters/query_bookmark'
      - description: Search locale.
        in: query
        name: locale
        required: false
        schema:
          type: string
      - $ref: '#/components/parameters/result_limit'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/SummaryPin'
          description: Success
        '400':
          description: Invalid pins
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid pin filter value
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - search
  /terms/related:
    get:
      summary: List related terms
      description: |-
        Get a list of terms logically related to each input term. <p/>
        Example: the term 'workout' would list related terms like 'one song workout', 'yoga workout', 'workout motivation', etc.
      tags:
      - terms
      operationId: terms_related/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_list_input_terms'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelatedTerms'
          description: Success
        '400':
          description: Invalid terms related parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid terms related parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /terms/suggested:
    get:
      summary: List suggested terms
      description: |-
        Get popular search terms that begin with your input term. <p/>
        Example: 'sport' would return popular terms like 'sports bar' and 'sportswear', but not 'motor sports' since the phrase does not begin with the given term.
      tags:
      - terms
      operationId: terms_suggested/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_input_term'
      - $ref: '#/components/parameters/query_term_limit'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TermsSuggestedResponse'
          description: Success
        '400':
          description: Invalid terms suggested parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid terms suggested parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /trends/keywords/{region}/top/{trend_type}:
    get:
      summary: List trending keywords
      description: |
        <p>Get the top trending search keywords among the Pinterest user audience.</p> <p>Trending keywords can be used to inform ad targeting, budget strategy, and creative decisions about which products and Pins will resonate with your audience.</p> <p>Geographic, demographic and interest-based filters are available to narrow down to the top trends among a specific audience. Multiple trend types are supported that can be used to identify newly-popular, evergreen or seasonal keywords.</p> <p>For an interactive way to explore this data, please visit <a href="https://trends.pinterest.com">trends.pinterest.com</a>.
      operationId: trending_keywords/list
      security:
      - pinterest_oauth2:
        - user_accounts:read
      x-ratelimit-category: trends_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_trend_region'
      - $ref: '#/components/parameters/path_trend_type'
      - $ref: '#/components/parameters/query_interest_list'
      - $ref: '#/components/parameters/query_gender_list'
      - $ref: '#/components/parameters/query_age_bucket_list'
      - name: include_keywords
        description: |-
          If set, filters the results to top trends which include at least one of the specified keywords.<br />
          If unset, no keyword filtering logic is applied.
        example:
        - recipes
        - dessert
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/KeywordList'
      - $ref: '#/components/parameters/query_normalize_against_group'
      - $ref: '#/components/parameters/query_trending_keyword_limit'
      - name: include_prediction
        description: |-
          <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Closed beta</a>
          Including predicted weekly search volume data for the next 90 days.
          By default (`false`), the response will not include predicted data.
        in: query
        required: false
        schema:
          type: boolean
          example: true
          default: false
      - name: include_demographics
        description: |-
          <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Closed beta</a>
          Including the age and gender distribution for each keyword.
          By default (`false`), the response will not include demographics data.
        in: query
        required: false
        schema:
          type: boolean
          example: true
          default: false
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrendingKeywordsResponse'
          description: Success
        '400':
          description: Invalid trending keywords request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid trending keywords request parameters
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - keywords
  /user_account:
    get:
      summary: Get user account
      description: |-
        Get account information for the "operation user_account"
        - By default, the "operation user_account" is the token user_account.

        If using Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account". See <a href='/docs/getting-started/using-business-access/'>Understanding Business Access</a> for more information.
      tags:
      - user_account
      operationId: user_account/get
      security:
      - pinterest_oauth2:
        - user_accounts:read
      - client_credentials:
        - user_accounts:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Account'
        '403':
          description: Not authorized to access the user account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to access the user account.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /user_account/analytics:
    get:
      summary: Get user account analytics
      description: |-
        Get analytics for the "operation user_account"
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
      tags:
      - user_account
      operationId: user_account/analytics
      security:
      - pinterest_oauth2:
        - user_accounts:read
      x-ratelimit-category: org_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_from_claimed_content'
      - $ref: '#/components/parameters/query_pin_format'
      - $ref: '#/components/parameters/query_app_types'
      - $ref: '#/components/parameters/query_content_type'
      - $ref: '#/components/parameters/query_source'
      - $ref: '#/components/parameters/query_metric_types'
      - $ref: '#/components/parameters/query_split_field_user_account'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsResponse'
          description: Success
        '400':
          description: Invalid user accounts analytics parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid user accounts analytics parameters.
        '403':
          description: Not authorized to access the user account analytics.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to access the user account analytics.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /user_account/analytics/top_pins:
    get:
      summary: Get user account top pins analytics
      description: |-
        Gets analytics data about a user's top pins (limited to the top 50).
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
      tags:
      - user_account
      operationId: user_account/analytics/top_pins
      security:
      - pinterest_oauth2:
        - pins:read
        - user_accounts:read
      - client_credentials:
        - pins:read
        - user_accounts:read
      x-ratelimit-category: org_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_sort_by'
      - $ref: '#/components/parameters/query_from_claimed_content'
      - $ref: '#/components/parameters/query_pin_format'
      - $ref: '#/components/parameters/query_app_types'
      - $ref: '#/components/parameters/query_content_type'
      - $ref: '#/components/parameters/query_source'
      - $ref: '#/components/parameters/query_metric_types'
      - $ref: '#/components/parameters/query_num_of_pins'
      - $ref: '#/components/parameters/query_created_in_last_n_days'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopPinsAnalyticsResponse'
          description: Success
        '403':
          description: Not authorized to access the user account analytics.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to access the user account analytics.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /user_account/analytics/top_video_pins:
    get:
      summary: Get user account top video pins analytics
      description: |-
        Gets analytics data about a user's top video pins (limited to the top 50).
        - By default, the "operation user_account" is the token user_account.

        Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".
      tags:
      - user_account
      operationId: user_account/analytics/top_video_pins
      security:
      - pinterest_oauth2:
        - pins:read
        - user_accounts:read
      - client_credentials:
        - pins:read
        - user_accounts:read
      x-ratelimit-category: org_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_start_date'
      - $ref: '#/components/parameters/query_end_date'
      - $ref: '#/components/parameters/query_video_pin_sort_by'
      - $ref: '#/components/parameters/query_from_claimed_content'
      - $ref: '#/components/parameters/query_pin_format'
      - $ref: '#/components/parameters/query_app_types'
      - $ref: '#/components/parameters/query_content_type'
      - $ref: '#/components/parameters/query_source'
      - $ref: '#/components/parameters/query_video_pin_metric_types'
      - $ref: '#/components/parameters/query_num_of_pins'
      - $ref: '#/components/parameters/query_created_in_last_n_days'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopVideoPinsAnalyticsResponse'
          description: Success
        '403':
          description: Not authorized to access the user account analytics.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to access the user account analytics.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /user_account/businesses:
    get:
      summary: List linked businesses
      description: Get a list of your linked business accounts.
      operationId: linked_business_accounts/get
      security:
      - pinterest_oauth2:
        - user_accounts:read
      - client_credentials:
        - user_accounts:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LinkedBusiness'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - user_account
  /user_account/followers:
    get:
      summary: List followers
      description: Get a list of your followers.
      operationId: followers/list
      security:
      - pinterest_oauth2:
        - user_accounts:read
      - client_credentials:
        - user_accounts:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/UserSummary'
          description: Success
        '400':
          description: Invalid user id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid user id
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - user_account
  /user_account/following:
    get:
      summary: List following
      description: Get a list of who a certain user follows.
      operationId: user_following/get
      security:
      - pinterest_oauth2:
        - user_accounts:read
      - client_credentials:
        - user_accounts:read
      x-ratelimit-category: org_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_user_following_feed_type'
      - $ref: '#/components/parameters/query_explicit_following'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          description: response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      description: Users
                      items:
                        $ref: '#/components/schemas/UserSummary'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - user_account
  /user_account/following/boards:
    get:
      summary: List following boards
      description: Get a list of the boards a user follows. The request returns a
        board summary object array.
      operationId: boards_user_follows/list
      security:
      - pinterest_oauth2:
        - user_accounts:read
      - client_credentials:
        - user_accounts:read
      x-ratelimit-category: org_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_explicit_following'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Board'
          description: Success
        '400':
          description: Invalid user id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid user id
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - user_account
  /user_account/following/{username}:
    post:
      summary: Follow user
      description: |-
        <strong>This endpoint is currently in beta and not available to all apps. <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>

        Use this request, as a signed-in user, to follow another user.
      tags:
      - user_account
      operationId: follow_user/update
      security:
      - pinterest_oauth2:
        - user_accounts:write
      x-ratelimit-category: org_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_username'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FollowUserRequest'
        description: Follow a user.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserSummary'
          description: Success
        '404':
          description: User not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UserNotFound:
                  value:
                    code: 30
                    message: User not found.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
  /user_account/websites:
    post:
      summary: Verify website
      description: Verify a website as a signed-in user.
      tags:
      - user_account
      operationId: verify_website/update
      security:
      - pinterest_oauth2:
        - user_accounts:write
      x-ratelimit-category: org_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      requestBody:
        description: Verify a website.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserWebsiteVerifyRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserWebsiteSummary'
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
    get:
      summary: Get user websites
      description: Get user websites, claimed or not
      tags:
      - user_account
      operationId: user_websites/get
      security:
      - pinterest_oauth2:
        - user_accounts:read
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/UserWebsiteSummary'
        '403':
          description: Not authorized to access the user website list.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to access the user website list.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-ratelimit-category: org_read
      x-sandbox: disabled
    delete:
      summary: Unverify website
      description: Unverifu a website verified by the signed-in user.
      tags:
      - user_account
      operationId: unverify_website/delete
      security:
      - pinterest_oauth2:
        - user_accounts:write
      x-ratelimit-category: org_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/query_website'
      responses:
        '204':
          description: Successfully unverified website
        '404':
          description: Website not in user list.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 404
                message: Website not in user list.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /user_account/websites/verification:
    get:
      summary: Get user verification code for website claiming
      description: Get verification code for user to install on the website to claim
        it.
      tags:
      - user_account
      operationId: website_verification/get
      parameters:
      - $ref: '#/components/parameters/query_ad_account_id'
      security:
      - pinterest_oauth2:
        - user_accounts:read
      - client_credentials:
        - user_accounts:read
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserWebsiteVerificationCode'
          description: Success
        '403':
          description: Not authorized to access the user verification code for website
            claiming.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 403
                message: Not authorized to access the user verification code for website
                  claiming.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      x-ratelimit-category: org_read
      x-sandbox: disabled
  /users/{username}/interests/follow:
    get:
      summary: List following interests
      description: Get a list of a user's following interests in one place.
      tags:
      - user_account
      operationId: user_account/followed_interests
      security:
      - pinterest_oauth2:
        - user_accounts:read
      - client_credentials:
        - user_accounts:read
      x-ratelimit-category: org_read
      parameters:
      - $ref: '#/components/parameters/path_username'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/Interest'
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authorization failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: User not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-sandbox: enabled
components:
  securitySchemes:
    pinterest_oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://www.pinterest.com/oauth/
          tokenUrl: https://api.pinterest.com/v5/oauth/token
          scopes:
            ads:read: See all of your advertising data, including ads, ad groups,
              campaigns etc.
            ads:write: Create, update, or delete ads, ad groups, campaigns etc.
            billing:read: See all of your billing data, billing profile, etc.
            billing:write: Create, update, or delete billing data, billing profiles,
              etc.
            biz_access:read: See business access data
            biz_access:write: Create, update, or delete business access data
            boards:read: See your public boards, including group boards you join
            boards:read_secret: See your secret boards
            boards:write: Create, update, or delete your public boards
            boards:write_secret: Create, update, or delete your secret boards
            catalogs:read: See all of your catalogs data
            catalogs:write: Create, update, or delete your catalogs data
            msot:write: Create measurement source of truth events
            pins:read: See your public Pins
            pins:read_secret: See your secret Pins
            pins:write: Create, update, or delete your public Pins
            pins:write_secret: Create, update, or delete your secret Pins
            user_accounts:read: See your user accounts and followers
            user_accounts:write: Update your user accounts and followers
    conversion_token:
      type: http
      scheme: bearer
      description: This security scheme only applies to the conversion events endpoint
        (POST /ad_accounts/{ad_account_id}/events). This endpoint requires a bearer
        token generated via Ads Manager (ads.pinterest.com).
    basic:
      type: http
      scheme: basic
    client_credentials:
      flows:
        clientCredentials:
          scopes:
            ads:read: See all of your advertising data, including ads, ad groups,
              campaigns etc.
            ads:write: Create, update, or delete ads, ad groups, campaigns etc.
            billing:read: See all of your billing data, billing profile, etc.
            billing:write: Create, update, or delete billing data, billing profiles,
              etc.
            biz_access:read: See business access data
            biz_access:write: Create, update, or delete business access data
            boards:read: See your public boards, including group boards you join
            boards:read_secret: See your secret boards
            boards:write: Create, update, or delete your public boards
            boards:write_secret: Create, update, or delete your secret boards
            catalogs:read: See all of your catalogs data
            catalogs:write: Create, update, or delete your catalogs data
            msot:write: Create measurement source of truth events
            pins:read: See your public Pins
            pins:read_secret: See your secret Pins
            pins:write: Create, update, or delete your public Pins
            pins:write_secret: Create, update, or delete your secret Pins
            user_accounts:read: See your user accounts and followers
            user_accounts:write: Update your user accounts and followers
          tokenUrl: https://api.pinterest.com/v3/oauth/access_token/
      type: oauth2
  schemas:
    Account:
      type: object
      readOnly: true
      properties:
        account_type:
          description: Type of account
          type: string
          enum:
          - PINNER
          - BUSINESS
        id:
          description: User account ID.
          type: string
          pattern: ^\d+$
          example: '2783136121146311751'
        profile_image:
          type: string
        website_url:
          type: string
        username:
          type: string
        about:
          description: Profile about description.
          type: string
        business_name:
          type: string
          nullable: true
        board_count:
          type: integer
          readOnly: true
          nullable: true
          example: 14
          description: 'User account board count.<br/>**Note**: Board count on user
            account level may differ from counts found elsewhere due to attribution
            of collaborative Boards.'
        pin_count:
          type: integer
          readOnly: true
          nullable: true
          example: 339
          description: User account pin count. This includes both created and saved
            pins.
        follower_count:
          type: integer
          readOnly: true
          nullable: true
          example: 10
          description: User account follower count.
        following_count:
          type: integer
          readOnly: true
          nullable: true
          example: 347
          description: User account following count.
        monthly_views:
          type: integer
          readOnly: true
          nullable: true
          example: 163
          description: User account monthly views.
    ActionType:
      type: string
      description: Ad group billable event type. For update, only draft ad groups
        may update billable event.
      example: CLICKTHROUGH
      enum:
      - CLICKTHROUGH
      - IMPRESSION
      - VIDEO_V_50_MRC
    AdAccount:
      type: object
      readOnly: true
      properties:
        id:
          type: string
        name:
          type: string
        owner:
          title: Ad account owner
          type: object
          properties:
            username:
              type: string
              description: Public username for the user account
            id:
              type: string
              description: The owning account's user ID.
        country:
          $ref: '#/components/schemas/Country'
        currency:
          $ref: '#/components/schemas/Currency'
        permissions:
          title: permissions
          type: array
          items:
            $ref: '#/components/schemas/BusinessAccessRole'
            nullable: true
        created_time:
          description: Creation time. Unix timestamp in seconds.
          example: 1451431341
          nullable: true
          title: created_time
          type: integer
        updated_time:
          description: Last update time. Unix timestamp in seconds.
          example: 1451431341
          nullable: true
          title: updated_time
          type: integer
    AdAccountAnalyticsResponse:
      type: array
      items:
        type: object
        properties:
          AD_ACCOUNT_ID:
            description: The ID of the advertiser that this metrics belongs to.
            type: string
            pattern: ^\d+$
          DATE:
            description: Current metrics date. Only returned when granularity is a
              time-based value (`DAY`, `HOUR`, `WEEK`, `MONTH`)
            type: string
            format: date
        required:
        - AD_ACCOUNT_ID
        additionalProperties: true
        example:
          DATE: '2021-04-01'
          AD_ACCOUNT_ID: '547602124502'
          SPEND_IN_DOLLAR: 30
          TOTAL_CLICKTHROUGH: 216
    AdAccountCreateRequest:
      title: AdAccountCreate
      type: object
      example:
        country: US
        currency: USD
        owner_user_id: '383791336903426391'
        name: ACME Tools
      properties:
        country:
          $ref: '#/components/schemas/Country'
        currency:
          $ref: '#/components/schemas/Currency'
        name:
          description: Ad Account name.
          example: ACME Tools
          maxLength: 256
          title: name
          type: string
        owner_user_id:
          description: Advertiser's owning user ID.
          example: '383791336903426391'
          pattern: ^\d+$
          title: owner_user_id
          type: string
    AdAccountCreateSubscriptionRequest:
      title: AdAccountCreateSubscriptionRequest
      type: object
      example:
        webhook_url: https://webhook.example.com/xyz
        lead_form_id: '383791336903426390'
      properties:
        webhook_url:
          description: Standard HTTPS webhook URL.
          example: https://webhook.example.com/xyz
          title: webhook_url
          type: string
        lead_form_id:
          description: Lead form ID.
          example: '383791336903426390'
          title: Lead form ID
          type: string
          pattern: ^\d+$
        partner_access_token:
          description: Partner access token. Only for clients that requires authentication.
            We recommend to avoid this param.
          type: string
        partner_refresh_token:
          description: Partner refresh token. Only for clients that requires authentication.
            We recommend to avoid this param.
          type: string
        partner_metadata:
          description: Partner metadata. Only for clients that requires special handling.
            We recommend to avoid this param.
          type: object
          properties:
            subscriber_key:
              description: Text field value that uniquely identifies a subscriber.
              type: string
      required:
      - webhook_url
    AdAccountCreateSubscriptionResponse:
      title: AdAccountCreateSubscriptionResponse
      type: object
      properties:
        id:
          description: Subscription ID.
          example: '8078432025948590686'
          type: string
          pattern: ^\d+$
        cryptographic_key:
          description: Base64 encoded key for client to decrypt lead data.
          example: ucvxbV2Tdss0vNeYsdh4Qfa/1Khm2b0PqXvXeTTZh54
          type: string
          nullable: true
        cryptographic_algorithm:
          description: Lead data encryption algorithm.
          example: AES-256-GCM
          type: string
          nullable: true
        created_time:
          description: Subscription creation time. Unix timestamp in milliseconds.
          example: 1699209842000
          type: integer
        user_account_id:
          description: User account used to subscribe lead data.
          example: '549755885175'
          type: string
          pattern: ^\d+$
        ad_account_id:
          description: The Ad Account ID that this lead form belongs to.
          example: '549755885176'
          type: string
          pattern: ^\d+$
        api_version:
          description: API version.
          example: v5
          type: string
        lead_form_id:
          description: Lead form ID.
          example: '383791336903426390'
          type: string
          pattern: ^\d+$
          nullable: true
        webhook_url:
          description: Standard HTTPS webhook URL.
          example: https://webhook.example.com/xyz
          type: string
    AdAccountGetSubscriptionResponse:
      title: AdAccountGetSubscriptionsResponse
      type: object
      allOf:
      - type: object
        description: Lead ads subscription response common fields.
        properties:
          lead_form_id:
            description: Lead form ID.
            example: '383791336903426390'
            type: string
            pattern: ^\d+$
            nullable: true
          webhook_url:
            description: Standard HTTPS webhook URL.
            example: https://webhook.example.com/xyz
            type: string
      - type: object
        properties:
          id:
            description: Subscription ID.
            example: '8078432025948590686'
            type: string
            pattern: ^\d+$
          user_account_id:
            description: User account used to subscribe lead data.
            example: '549755885175'
            type: string
            pattern: ^\d+$
          ad_account_id:
            description: The Ad Account ID that this lead form belongs to.
            example: '549755885176'
            type: string
            pattern: ^\d+$
          api_version:
            description: API version.
            example: v5
            type: string
          cryptographic_key:
            description: Base64 encoded key for client to decrypt lead data.
            example: ucvxbV2Tdss0vNeYsdh4Qfa/1Khm2b0PqXvXeTTZh54
            type: string
            nullable: true
          cryptographic_algorithm:
            description: Lead data encryption algorithm.
            example: AES-256-GCM
            type: string
            nullable: true
          created_time:
            description: Lead subscription creation time. Unix timestamp in milliseconds.
            example: 1699209842000
            type: integer
    AdAccountsCountryResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AdAccountsCountryResponseData'
    AdAccountsCountryResponseData:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/AdCountry'
          type: string
        currency:
          description: Country currency.
          example: Dollars
          type: string
        index:
          type: number
          description: Country index
          example: 1
        name:
          type: string
          description: Country name
          example: United States of America
    AdArrayResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AdArrayResponseElement'
      title: AdArrayResponse
    AdArrayResponseElement:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/AdResponse'
        exceptions:
          $ref: '#/components/schemas/Exception'
    AdCommon:
      type: object
      description: Creation fields
      properties:
        ad_group_id:
          description: ID of the ad group that contains the ad.
          example: '2680059592705'
          type: string
          pattern: ^(AG)?\d+$
        android_deep_link:
          description: Deep link URL for Android devices.
          nullable: true
          type: string
        carousel_android_deep_links:
          description: Comma-separated deep links for the carousel pin on Android.
          type: array
          nullable: true
          items:
            type: string
        carousel_destination_urls:
          description: Comma-separated destination URLs for the carousel pin to promote.
          type: array
          nullable: true
          items:
            type: string
        carousel_ios_deep_links:
          description: Comma-separated deep links for the carousel pin on iOS.
          type: array
          nullable: true
          items:
            type: string
        click_tracking_url:
          description: Tracking url for the ad clicks.
          type: string
          nullable: true
        creative_type:
          $ref: '#/components/schemas/CreativeType'
        destination_url:
          description: Destination URL.
          type: string
          nullable: true
        ios_deep_link:
          description: Deep link URL for iOS devices.
          type: string
          nullable: true
        is_pin_deleted:
          description: Is original pin deleted?
          example: false
          type: boolean
        is_removable:
          description: Is pin repinnable?
          example: false
          type: boolean
        name:
          description: Name of the ad - 255 chars max.
          type: string
          nullable: true
        status:
          $ref: '#/components/schemas/EntityStatus'
        tracking_urls:
          type: object
          allOf:
          - $ref: '#/components/schemas/TrackingUrls'
          nullable: true
        view_tracking_url:
          description: Tracking URL for ad impressions.
          type: string
          nullable: true
        lead_form_id:
          description: Lead form ID for lead ad generation.
          type: string
          pattern: ^(AG)?\d+$
          nullable: true
        grid_click_type:
          $ref: '#/components/schemas/GridClickType'
        customizable_cta_type:
          type: string
          description: Select a call to action (CTA) to display below your ad. Available
            only for ads with direct links enabled. CTA options for consideration
            and conversion campaigns are LEARN_MORE, SHOP_NOW, BOOK_NOW, SIGN_UP,
            VISIT_SITE, BUY_NOW, GET_OFFER, ORDER_NOW, ADD_TO_CART (for conversion
            campaigns with add to cart conversion events only)
          example: LEARN_MORE
          nullable: true
          enum:
          - GET_OFFER
          - LEARN_MORE
          - ORDER_NOW
          - SHOP_NOW
          - SIGN_UP
          - SUBSCRIBE
          - BUY_NOW
          - CONTACT_US
          - GET_QUOTE
          - VISIT_SITE
          - APPLY_NOW
          - BOOK_NOW
          - REQUEST_DEMO
          - REGISTER_NOW
          - FIND_A_DEALER
          - ADD_TO_CART
          - WATCH_NOW
          - READ_MORE
          - BUY_TICKETS
          - DONATE_NOW
          - DOWNLOAD
          - EXPLORE_MORE
          - FIND_A_LOCATION
          - GET_DEAL
          - GET_RECIPE
          - GET_SHOWTIMES
          - ON_SALE
          - PLAY_GAME
          - TRY_IT
          - null
        quiz_pin_data:
          type: object
          allOf:
          - $ref: '#/components/schemas/QuizPinData'
          description: Before creating a quiz ad, you must create an organic Pin using
            POST/Create Pin for each result in the quiz. Quiz ads cannot be saved
            by a Pinner. Quiz ad results can be saved.
          nullable: true
    AdCountry:
      type: string
      description: Country ID from ISO 3166-1 alpha-2.
      example: US
      enum:
      - 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
    AdCreateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/AdCommon'
      - $ref: '#/components/schemas/AdPinId'
      - type: object
        title: Request schema for creating ads
        required:
        - ad_group_id
        - pin_id
        - creative_type
    AdPinAnalytics:
      type: object
      properties:
        PIN_ID:
          description: The ID of the pin that the metric belongs to.
          type: string
          pattern: ^\d+$
        DATE:
          description: Current metrics date. Only returned when granularity is a time-based
            value (`DAY`, `HOUR`, `WEEK`, `MONTH`)
          type: string
          format: date
      required:
      - PIN_ID
      additionalProperties: true
      example:
        DATE: '2021-04-01'
        PIN_ID: '217861700718936379'
        SPEND_IN_DOLLAR: 30
        TOTAL_CLICKTHROUGH: 216
    AdPinsAnalyticsResponse:
      type: array
      items:
        $ref: '#/components/schemas/AdPinAnalytics'
    AdvancedAuctionItemsGetRequest:
      type: object
      description: Request object used to get bid options values for a batch of retail
        catalog items
      additionalProperties: false
      properties:
        catalog_id:
          description: Catalog id pertaining to the retail item
          example: '2680059592705'
          type: string
          pattern: ^\d+$
        items:
          type: array
          minItems: 1
          maxItems: 10000
          description: A list of retail catalog items to fetch bid options for
          items:
            $ref: '#/components/schemas/AdvancedAuctionItemsGetRecord'
      required:
      - catalog_id
      - items
    AdvancedAuctionItemsGetRecord:
      description: Object uniquely identifying a retail catalog item
      allOf:
      - $ref: '#/components/schemas/AdvancedAuctionKey'
    AdvancedAuctionItems:
      type: object
      description: Response object containing item bid options
      properties:
        catalog_id:
          description: Response object of item bid options
          example: '2680059592705'
          type: string
          pattern: ^\d+$
        items:
          type: array
          description: Array with item bid options
          items:
            $ref: '#/components/schemas/AdvancedAuctionItem'
    AdvancedAuctionItemsSubmitRequest:
      type: object
      description: Request containing operations to perform on bid prices and bid
        multipliers for a batch of retail catalog items
      additionalProperties: false
      properties:
        catalog_id:
          description: Catalog id pertaining to all items
          example: '2680059592705'
          type: string
          pattern: ^\d+$
        items:
          type: array
          minItems: 1
          maxItems: 10000
          description: Array of item bid option operations
          items:
            $ref: '#/components/schemas/AdvancedAuctionItemsSubmitRecord'
      required:
      - catalog_id
      - items
    AdvancedAuctionItemsSubmitRecord:
      type: object
      description: Object describing an item bid option operation
      oneOf:
      - $ref: '#/components/schemas/AdvancedAuctionItemsSubmitUpsertRecord'
      - $ref: '#/components/schemas/AdvancedAuctionItemsSubmitDeleteRecord'
      discriminator:
        propertyName: operation
        mapping:
          UPSERT: '#/components/schemas/AdvancedAuctionItemsSubmitUpsertRecord'
          DELETE: '#/components/schemas/AdvancedAuctionItemsSubmitDeleteRecord'
      properties:
        operation:
          $ref: '#/components/schemas/AdvancedAuctionOperation'
      required:
      - operation
    AdvancedAuctionItemsSubmitUpsertRecord:
      description: Object describing an item bid option upsert operation
      example:
        item_id: DS0294-M
        country: US
        language: EN
        operation: UPSERT
        bid_options:
          bid_in_micro_currency: 5000000
          app_type_multipliers:
            android_mobile: 1.1
            android_tablet: 1.1
            ipad: 1.2
            iphone: 1.2
            web: 0.9
            web_mobile: 0.8
        update_mask:
        - BID
        - APP_TYPE_BID_MULTIPLIER_SET
      allOf:
      - $ref: '#/components/schemas/AdvancedAuctionItem'
      - type: object
        properties:
          update_mask:
            type: array
            description: The list of item bid option fields to be set or updated.
              Fields specified in the updated mask without a value specified in the
              `bid_options` object in the body will be set to `null`. If an item bid
              option record is being created, fields not specified in the update mask
              will be initialized to `null`.
            example:
            - BID
            - APP_TYPE_BID_MULTIPLIER_SET
            nullable: true
            items:
              $ref: '#/components/schemas/UpdateMaskBidOptionField'
        required:
        - update_mask
    AdvancedAuctionItemsSubmitDeleteRecord:
      description: Object describing an item bid option deletion operation
      example:
        item_id: DS0294-M
        country: US
        language: EN
        operation: DELETE
      allOf:
      - $ref: '#/components/schemas/AdvancedAuctionKey'
    AdvancedAuctionProcessedItems:
      type: object
      description: Response object containing the results of an operation on an item
        bid option
      properties:
        catalog_id:
          description: Catalog id pertaining to all items
          example: '2680059592705'
          type: string
          pattern: ^\d+$
        items:
          type: array
          description: Array of advanced auction processed items
          items:
            $ref: '#/components/schemas/AdvancedAuctionProcessedItem'
    AdvancedAuctionProcessedItem:
      description: Object describing the result of an operation on an item bid option
      type: object
      allOf:
      - $ref: '#/components/schemas/AdvancedAuctionItemsSubmitRecord'
      - type: object
        properties:
          errors:
            type: array
            description: |-
              Array with validation errors for the supplied item bid option modification operation.
              A non empty errors list means this single item operation was not applied.
            items:
              $ref: '#/components/schemas/AdvancedAuctionOperationError'
    AdvancedAuctionItem:
      title: Advanced Auction Item
      allOf:
      - $ref: '#/components/schemas/AdvancedAuctionKey'
      - type: object
        properties:
          bid_options:
            $ref: '#/components/schemas/AdvancedAuctionBidOptions'
        required:
        - bid_options
    AdvancedAuctionKey:
      type: object
      description: Object uniquely identifying a retail catalog item
      properties:
        item_id:
          description: The catalog retail item id in the merchant namespace
          example: DS0294-M
          type: string
        country:
          $ref: '#/components/schemas/Country'
        language:
          $ref: '#/components/schemas/Language'
      required:
      - item_id
      - country
      - language
    AdvancedAuctionOperation:
      type: string
      enum:
      - UPSERT
      - DELETE
    AdvancedAuctionBidOptions:
      type: object
      description: Object describing a retail catalog item's bid options (bid price
        and bid multipliers).
      properties:
        bid_in_micro_currency:
          $ref: '#/components/schemas/BidInMicroCurrency'
        app_type_multipliers:
          $ref: '#/components/schemas/AppTypeMultipliers'
        placement_multipliers:
          $ref: '#/components/schemas/PlacementMultipliers'
    AdvancedAuctionOperationError:
      description: Error which occurred when applying a bid options operation to a
        specific item.
      type: object
      properties:
        code:
          description: The error code for the item bid option operation validation
            error
          type: integer
          example: 6
        message:
          description: Message describing the item bid option operation validation
            error
          type: string
          example: Bid in micro currency should be non-negative
    BidInMicroCurrency:
      type: integer
      format: int64
      description: Bid price in micro currency. A value of 0 will stop distribution
        for this item in `MAX_BID` ad groups in `CATALOG_SALES` campaigns. A value
        of `null` will fallback to the ad group's `bid_in_micro_currency`.
      example: 5000000
      nullable: true
    AppTypeMultipliers:
      type: object
      description: |-
        This represents a mapping from app type targeting criteria to a bid price adjustment.

        Multiplier values must be between 0 and 10. A value of 10 represents a 900% increase in bid price (from $1 to $10 for example). A value of 0 will stop distribution for this item on the specified app type in `MAX_BID` ad groups in `CATALOG_SALES` campaigns. All app type multipliers must be set at the same time. If a multiplier is not provided it is assumed to be 1 (no bid adjustment).
      example:
        android_mobile: 1.1
        android_tablet: 1.1
        ipad: 1.2
        iphone: 1.2
        web: 0.9
        web_mobile: 0.8
      properties:
        APP_TYPE:
          $ref: '#/components/schemas/TargetingSpecAppType'
      additionalProperties:
        type: number
        format: double
      nullable: true
    TargetingSpecAppType:
      type: string
      enum:
      - android_mobile
      - android_tablet
      - ipad
      - iphone
      - web
      - web_mobile
    PlacementMultipliers:
      type: object
      description: |-
        This represents a mapping from placement to a bid price adjustment.

        Multiplier values must be between 0 and 10. A value of 10 represents a 900% increase in bid price (from $1 to $10 for example). A value of 0 will stop distribution for this item on the specified placement in `MAX_BID` ad groups in `CATALOG_SALES` campaigns. All placement multipliers must be set at the same time. If a multiplier is not provided it is assumed to be 1 (no bid adjustment).
      example:
        browse: 0.9
        search: 1.2
        related_pins: 1.1
      properties:
        PLACEMENT:
          type: string
          enum:
          - SEARCH
          - BROWSE
          - RELATED_PINS
      additionalProperties:
        type: number
        format: double
      nullable: true
    UpdateMaskBidOptionField:
      type: string
      description: bid option field to apply operation updates to
      example: BID
      enum:
      - BID
      - APP_TYPE_BID_MULTIPLIER_SET
      - PLACEMENT_BID_MULTIPLIER_SET
    AdGroupArrayResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AdGroupArrayResponseElement'
    AdGroupArrayResponseElement:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/AdGroupResponse'
        exceptions:
          type: array
          items:
            $ref: '#/components/schemas/Exception'
    AdGroupCommon:
      type: object
      properties:
        name:
          description: Ad group name.
          type: string
          example: 'Ad Group For Pin: 687195905986'
        status:
          type: string
          allOf:
          - $ref: '#/components/schemas/EntityStatus'
          description: Ad group/entity status.
        budget_in_micro_currency:
          description: Budget in micro currency. This field is **REQUIRED** for non-CBO
            (campaign budget optimization) campaigns.  A CBO campaign automatically
            generates ad group budgets from its campaign budget to maximize campaign
            outcome. A CBO campaign is limited to 70 or less ad groups.
          type: integer
          example: 5000000
          nullable: true
        bid_in_micro_currency:
          description: 'Bid price in micro currency. This field is **REQUIRED** for
            the following campaign objective_type/billable_event combinations: AWARENESS/IMPRESSION,
            CONSIDERATION/CLICKTHROUGH, CATALOG_SALES/CLICKTHROUGH.'
          type: integer
          example: 5000000
          nullable: true
        optimization_goal_metadata:
          type: object
          allOf:
          - $ref: '#/components/schemas/OptimizationGoalMetadata'
          description: Optimization goals for objective-based performance campaigns.
            **REQUIRED** when campaign's `objective_type` is set to `"WEB_CONVERSION"`.
          nullable: true
        budget_type:
          type: string
          allOf:
          - $ref: '#/components/schemas/BudgetType'
        start_time:
          description: |-
            Timestamp in Unix format for scheduling when ads in the ad group start to appear. If not specified, ads appear during parent campaign's `start_time`. Cannot precede `start_time` for parent campaign (if specified). Learn about <a href="/docs/api-features/managing-ads/#step-2-create-an-ad-group" target="blank">scheduling ads</a>.
            For certain organizations (<a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Closed beta</a>): Supported for campaigns with Campaign Budget Optimization (CBO).
            For all organizations: Supported for campaigns without CBO.
          type: integer
          example: 5686848000
          nullable: true
        end_time:
          description: |-
            Timestamp in Unix format for scheduling when ads in the ad group stop appearing. If not specified, ads run indefinitely unless you update the ad group by changing their status to `paused`. Cannot occur after `end_time` for parent campaign (if specified). Learn about <a href="/docs/api-features/managing-ads/#step-2-create-an-ad-group" target="blank">scheduling ads</a>.
            For certain organizations (<a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Closed beta</a>): Supported for campaigns with Campaign Budget Optimization (CBO).
            For all organizations: Supported for campaigns without CBO.
          type: integer
          example: 5705424000
          nullable: true
        targeting_spec:
          $ref: '#/components/schemas/TargetingSpec'
        lifetime_frequency_cap:
          description: Set a limit to the number of times a promoted pin from this
            campaign can be impressed by a pinner within the past rolling 30 days.
            Only available for CPM (cost per mille (1000 impressions))  ad groups.
            A CPM ad group has an IMPRESSION <a href="/docs/redoc/#section/Billable-event">billable_event</a>
            value. This field **REQUIRES** the `end_time` field.
          type: integer
          example: 100
        tracking_urls:
          type: object
          allOf:
          - $ref: '#/components/schemas/TrackingUrls'
          description: 'Third-party tracking URLs.<br> JSON object with the format:
            {"<a href="/docs/redoc/#section/Tracking-URL-event">Tracking event enum</a>":[URL
            string array],...}<br> For example: {"impression": ["URL1", "URL2"], "click":
            ["URL1", "URL2", "URL3"]}.<br>Up to three tracking URLs are supported
            for each event type. Tracking URLs set at the ad group or ad level can
            override those set at the campaign level. May be null. Pass in an empty
            object - {} - to remove tracking URLs.<br><br> For more information, see
            <a href="https://help.pinterest.com/en/business/article/third-party-and-dynamic-tracking"
            target="_blank">Third-party and dynamic tracking</a>.'
          nullable: true
        auto_targeting_enabled:
          type: boolean
          description: Enable auto-targeting for ad group. Default value is True.
            Also known as <a href="https://help.pinterest.com/en/business/article/performance-plus-targeting"
            target="_blank">"Pinterest Performance+ targeting"</a>.
          example: true
          nullable: true
        placement_group:
          type: string
          allOf:
          - $ref: '#/components/schemas/PlacementGroupType'
          description: <a href="/docs/redoc/#section/Placement-group">Placement group</a>.
        pacing_delivery_type:
          type: string
          allOf:
          - $ref: '#/components/schemas/PacingDeliveryType'
        campaign_id:
          description: Campaign ID of the ad group.
          type: string
          pattern: ^[C]?\d+$
          example: '626736533506'
        billable_event:
          $ref: '#/components/schemas/ActionType'
        bid_strategy_type:
          nullable: true
          description: Bid strategy type. For Campaigns with Video Completion objectives,
            the only supported bid strategy type is AUTOMATIC_BID, also known as "Pinterest
            Performance+ bidding".
          enum:
          - AUTOMATIC_BID
          - MAX_BID
          - TARGET_AVG
          - null
          example: MAX_BID
          title: BidStrategyType
          type: string
        targeting_template_ids:
          type: array
          description: 'Targeting template IDs applied to the ad group. We currently
            only support 1 targeting template per ad group. To use targeting templates,
            do not set any other targeting fields: targeting_spec, tracking_urls,
            auto_targeting_enabled, placement_group. To clear all targeting template
            IDs, set this field to [''0''].'
          items:
            description: Targeting template ID.
            type: string
            pattern: ^\d+$
            example: '643'
          maxItems: 1
          nullable: true
        is_creative_optimization:
          type: boolean
          description: Enable creative optimization for the ad group, default value
            is FALSE. When enabled, you allow Pinterest to automatically turn your
            product Pins into ads in different formats (collections and shopping)
            and deliver those ads to users at scale.
          example: true
          nullable: true
        promotion_id:
          type: string
          description: Promotion ID. To clear this field, set to null.
          pattern: ^\d+$
          example: '7834020347906'
          nullable: true
          default: '0'
        promotion_application_level:
          type: string
          description: Specify if the promotion is applied at ad group or item level
          nullable: true
          example: ITEM
          enum:
          - NONE
          - ITEM
          - AD_GROUP
          - null
    AdGroupCreateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/AdGroupCommon'
      - type: object
        properties:
          pacing_delivery_type:
            type: string
            allOf:
            - $ref: '#/components/schemas/PacingDeliveryType'
            default: STANDARD
          auto_targeting_enabled:
            type: boolean
            allOf:
            - type: boolean
              description: Enable auto-targeting for ad group. Default value is True.
                Also known as <a href="https://help.pinterest.com/en/business/article/performance-plus-targeting"
                target="_blank">"Pinterest Performance+ targeting"</a>.
              example: true
          budget_type:
            type: string
            allOf:
            - $ref: '#/components/schemas/BudgetType'
            default: DAILY
          bid_multiplier:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank>Open beta</a>
              Bid multiplier for ad group. This value is a double between 0.1
              and 10.0. Enter 0 to remove the bid multiplier.
              - Make sure the `bid_strategy` type for your ad group is set to `AUTOMATIC_BID`.
              - Not currently supported for <a href="/docs/api-features/pinterest-performance-plus-setup/" target="blank">Pinterest Performance+ campaigns</a>.
            type: number
            example: 1
            minimum: 0
            maximum: 10
        required:
        - billable_event
        - campaign_id
        - name
    AdGroupResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/AdGroupCommon'
      - type: object
        properties:
          id:
            description: Ad group ID.
            type: string
            pattern: ^\d+$
            example: '2680060704746'
          ad_account_id:
            description: Advertiser ID.
            type: string
            pattern: ^\d+$
            example: '549755885175'
          created_time:
            description: Ad group creation time. Unix timestamp in seconds.
            type: integer
            example: 1476477189
          updated_time:
            description: Ad group last update time. Unix timestamp in seconds.
            type: integer
            example: 1476477189
          type:
            description: Always "adgroup".
            type: string
            default: adgroup
          conversion_learning_mode_type:
            type: string
            description: oCPM learn mode
            example: ACTIVE
            nullable: true
            enum:
            - NOT_ACTIVE
            - ACTIVE
            - null
          summary_status:
            type: string
            allOf:
            - $ref: '#/components/schemas/AdGroupSummaryStatus'
            description: Ad group summary status.
          feed_profile_id:
            description: Feed Profile ID associated to the adgroup.
            type: string
            example: '626736533506'
          dca_assets:
            description: '[DCA] The Dynamic creative assets to use for DCA. Dynamic
              Creative Assembly (DCA) accepts basic creative assets of an ad (image,
              video, title, call to action, logo etc). Then it automatically generates
              optimized ad combinations based on these assets.'
          bid_multiplier:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank>Open beta</a>
              Bid multiplier for ad group. This value is a double between 0.1
              and 10.0. Enter 0 to remove the bid multiplier.
              - Not currently supported for <a href="/docs/api-features/pinterest-performance-plus-setup/" target="blank">Pinterest Performance+ campaigns</a>.
            type: number
            example: 1
            minimum: 0
            maximum: 10
            nullable: true
    AdGroupSummaryStatus:
      type: string
      description: Summary status for ad group
      example: RUNNING
      enum:
      - RUNNING
      - PAUSED
      - NOT_STARTED
      - COMPLETED
      - ADVERTISER_DISABLED
      - ARCHIVED
      - DRAFT
      - DELETED_DRAFT
    AdGroupUpdateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/AdGroupCommon'
      - type: object
        properties:
          id:
            description: Ad group ID.
            type: string
            pattern: ^\d+$
            example: '2680060704746'
          bid_multiplier:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank>Open beta</a>
              Bid multiplier for ad group. This value is a double between 0.1
              and 10.0. Enter 0 to remove the bid multiplier.
              - Make sure the `bid_strategy` type for your ad group is set to `AUTOMATIC_BID`.
              - Not currently supported for <a href="/docs/api-features/pinterest-performance-plus-setup/" target="blank">Pinterest Performance+ campaigns</a>.
            type: number
            example: 1
            minimum: 0
            maximum: 10
        required:
        - id
    AdGroupsAnalyticsResponse:
      type: array
      items:
        type: object
        properties:
          AD_GROUP_ID:
            description: The ID of the ad group that this metrics belongs to. Returned
              as long as aggregate_report_rows is not true.
            type: string
            pattern: ^\d+$
          DATE:
            description: Current metrics date. Only returned when granularity is a
              time-based value (`DAY`, `HOUR`, `WEEK`, `MONTH`)
            type: string
            format: date
        additionalProperties: true
        example:
          DATE: '2021-04-01'
          AD_GROUP_ID: '547602124502'
          SPEND_IN_DOLLAR: 30
          TOTAL_CLICKTHROUGH: 216
    AdGroupAudienceSizingRequest:
      type: object
      properties:
        auto_targeting_enabled:
          type: boolean
          description: Enable auto-targeting for ad group. Default value is True.
            Also known as <a href="https://help.pinterest.com/en/business/article/performance-plus-targeting"
            target="_blank">"Pinterest Performance+ targeting"</a>.
          example: true
          default: true
        placement_group:
          type: string
          allOf:
          - $ref: '#/components/schemas/PlacementGroupType'
          default: ALL
          description: <a href="/docs/redoc/#section/Placement-group">Placement group</a>.
        creative_types:
          description: Pin creative types filter. </p><strong>Note:</strong> SHOP_THE_PIN
            has been deprecated. Please use COLLECTION instead.
          type: array
          items:
            type: string
            example: REGULAR
            enum:
            - REGULAR
            - VIDEO
            - SHOPPING
            - CAROUSEL
            - MAX_VIDEO
            - SHOP_THE_PIN
            - COLLECTION
            - IDEA
          nullable: true
        targeting_spec:
          $ref: '#/components/schemas/TargetingSpec'
        product_group_ids:
          type: array
          items:
            type: string
            pattern: ^\d+$
            example: '23423422123'
          description: Targeted product group IDs. </p><strong>Note:</strong> This
            can only be combined with shopping/catalog sales campaigns. For more information,
            <a href="https://help.pinterest.com/en/business/article/shopping-ads#section-14571"
            target="_blank">click here</a>. SHOPPING_RETARGETING must be included
            in targeting_spec object or this field will be ignored.
          nullable: true
        keywords:
          type: array
          description: Array of keyword objects. If the keywords field is missing,
            all keywords will be targeted.
          items:
            type: object
            properties:
              match_type:
                $ref: '#/components/schemas/MatchTypeResponse'
              value:
                type: string
                description: Keyword value (120 chars max).
            required:
            - match_type
            - value
          nullable: true
    AdGroupAudienceSizingResponse:
      type: object
      properties:
        audience_size_lower_bound:
          description: The lower confidence bound of the estimated potential audience
            size. "Potential audience size" estimates the number of people you may
            be able to reach per month with your campaign. It is based on historical
            advertising data and the targeting criteria you select. It does not guarantee
            results or take into account factors such as bid, budget, schedule, seasonality
            or product experiments.
          type: number
          example: 100000
        audience_size_upper_bound:
          description: The upper confidence bound of the estimated potential audience
            size. "Potential audience size" estimates the number of people you may
            be able to reach per month with your campaign. It is based on historical
            advertising data and the targeting criteria you select. It does not guarantee
            results or take into account factors such as bid, budget, schedule, seasonality
            or product experiments.
          type: number
          example: 150000
    AdPinId:
      type: object
      properties:
        pin_id:
          description: Pin ID.
          example: '394205773611545468'
          type: string
          pattern: ^\d+$
    AdPreviewRequest:
      oneOf:
      - example:
          image_url: https://somewebsite.com/someimage.jpg
          title: My Preview Image
        properties:
          image_url:
            description: Image URL.
            example: https://somewebsite.com/someimage.jpg
            title: image_url
            type: string
          title:
            description: Title displayed below ad.
            example: My Preview Image
            title: title
            type: string
        required:
        - image_url
        - title
        title: AdPreviewCreateFromImage
        type: object
      - example:
          pin_id: '7389479023'
        properties:
          pin_id:
            description: Pin ID.
            example: '7389479023'
            title: pin_id
            type: string
        required:
        - pin_id
        title: AdPreviewCreateFromPin
        type: object
      - example:
          catalog_product_group_id: '123456789'
          image_tag: Christmas Sale
          creative_type: COLLECTION
          hero_pin_id: '987654321'
        properties:
          catalog_product_group_id:
            description: Catalog Product Group Id.
            example: '123456789'
            title: catalog_product_group_id
            type: string
            pattern: ^\d+$
          customizable_cta_type:
            $ref: '#/components/schemas/ProductGroupPromotion/properties/customizable_cta_type'
          image_tag:
            description: Multi image template tag.
            example: Christmas Sale
            title: image_tag
            type: string
          video_tag:
            description: Multi video template tag, image_tag and video_tag are mutual
              exclusive.
            example: Black Friday Sale
            title: video_tag
            type: string
          preferred_media_type:
            type: string
            enum:
            - VIDEO
            - IMAGE
            description: Preferred media type.
            example: IMAGE
          creative_type:
            type: string
            enum:
            - SHOPPING
            - CAROUSEL
            - COLLECTION
            description: Ad format of the shopping ad preview.
            example: SHOPPING
          hero_pin_id:
            description: Pin id for the hero image. When creative type is COLLECTION,
              either hero_pin_id or (hero_image_url, hero_image_title) is required.
            example: '987654321'
            title: hero_pin_id
            type: string
            pattern: ^\d+$
          hero_image_url:
            description: Hero image URL.
            example: https://somewebsite.com/someimage.jpg
            title: hero_image_url
            type: string
          hero_image_title:
            description: Title displayed below ad.
            example: My Preview Image
            title: hero_image_title
            type: string
          item_id:
            description: Item id for product to preview standard shopping ads, optional
              and only applicable when creative type is SHOPPING.
            example: '111111111'
            title: item_id
            type: string
        required:
        - catalog_product_group_id
        - creative_type
        title: AdPreviewShopping
        type: object
    AdPreviewURLResponse:
      example:
        url: https://ads.pinterest.com/ad-preview/58f1a0e9ab0bd0f99462a0e4c5dd7e8297888c8a36331e88f757abe8f0295d31/
      properties:
        url:
          description: |-
            'Preview URL, expires in 7 days. Can be used in an iframe.
            For example: https://ads.pinterest.com/ad-preview/74667c814dd2b19/
            The preview object ID/key is the last param - 74667c814dd2b19'
          example: https://ads.pinterest.com/ad-preview/58f1a0e9ab0bd0f99462a0e4c5dd7e8297888c8a36331e88f757abe8f0295d31/
          title: url
          type: string
      title: AdPreviewURLResponse
      type: object
    AdResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/AdCommon'
      - $ref: '#/components/schemas/AdPinId'
      - type: object
        properties:
          ad_account_id:
            description: The ID of the advertiser that this ad belongs to.
            example: '549755885175'
            type: string
            pattern: ^\d+$
          campaign_id:
            description: ID of the ad campaign that contains this ad.
            example: '626735565838'
            type: string
            pattern: ^\d+$
          collection_items_destination_url_template:
            description: Destination URL template for all items within a collections
              drawer.
            type: string
            nullable: true
          created_time:
            description: Pin creation time. Unix timestamp in seconds.
            example: 1451431341
            type: integer
          id:
            description: The ID of this ad.
            example: '687195134316'
            type: string
            pattern: ^\d+$
          rejected_reasons:
            description: Enum reason why the pin was rejected. Returned if <code>review_status</code>
              is "REJECTED".
            type: array
            items:
              type: string
              description: ad disapproval reasons
              enum:
              - HASHTAGS
              - PROMOTIONS_AND_PRICES
              - TARGETING
              - LANDING_PAGE
              - CAPS_AND_SYMBOLS
              - SHOCKING
              - WEIGHT_LOSS
              - PROHIBITED_PRODUCT
              - AUTHENTICITY
              - NUDITY
              - CONFUSING_DESIGN
              - URGENCY
              - RATINGS
              - APP
              - ALCOHOL
              - CONTESTS
              - POLITICAL
              - OTHER
              - IMAGE
              - NAR
              - INCONSISTENT
              - CLICKBAIT
              - NO_DESCRIPTION
              - LOW_QUALITY
              - EXAGGERATED_CLAIMS
              - PINTEREST_BRAND
              - ALCOHOL_NO_SALE
              - LANDING_PAGE_SPEED
              - LANDING_PAGE_HARDWALL
              - LANDING_PAGE_BROKEN
              - LANDING_PAGE_QUALITY
              - OUT_OF_STOCK
              - IMAGE_LOW_QUALITY
              - IMAGE_BUSY
              - IMAGE_POORLY_EDITED
              - IMAGE_BEFORE_AFTER
              - UGC
              - FAKE_BUTTONS
              - WEAPONS
              - SENSITIVE
              - UNACCEPTABLE_BUSINESS
              - SUSPICIOUS_CLAIMS
              - PHARMA
              - SUSPICIOUS_SUPPLEMENTS
              - ILLEGAL_RECREATIONAL_DRUG
              - LOW_QUALITY_LANDING_PAGE
              - RESTRICTED_HEALTHCARE
              - INCONSISTENT_LANG_FR
          rejection_labels:
            description: Text reason why the pin was rejected. Returned if <code>review_status</code>
              is "REJECTED".
            type: array
            items:
              type: string
          review_status:
            type: string
            description: Ad review status
            example: PENDING
            enum:
            - OTHER
            - PENDING
            - REJECTED
            - APPROVED
          type:
            description: Always "ad".
            example: pinpromotion
            type: string
          updated_time:
            description: Last update time. Unix timestamp in seconds.
            example: 1451431341
            type: integer
          summary_status:
            type: string
            allOf:
            - $ref: '#/components/schemas/PinPromotionSummaryStatus'
            description: Ad summary status
    AdUpdateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/AdCommon'
      - type: object
        title: AdUpdateRequest
        properties:
          id:
            type: string
            example: '687195134316'
            pattern: ^\d+$
            description: The ID of this ad.
            title: id
          pin_id:
            type: string
            description: Pin ID. This field may only be updated for draft ads.
            example: '394205773611545468'
            pattern: ^\d+$
            nullable: true
        required:
        - id
    AdsAnalyticsAdGroupTargetingType:
      type: string
      description: Reporting targeting type for ad groups
      example: APPTYPE
      enum:
      - KEYWORD
      - APPTYPE
      - GENDER
      - LOCATION
      - PLACEMENT
      - COUNTRY
      - TARGETED_INTEREST
      - PINNER_INTEREST
      - AUDIENCE_INCLUDE
      - GEO
      - AGE_BUCKET
      - REGION
      - AGE_BUCKET_AND_GENDER
      - CREATIVE_ENHANCEMENTS
    AdsAnalyticsAdTargetingType:
      type: string
      description: Reporting targeting type for ads
      example: APPTYPE
      enum:
      - KEYWORD
      - APPTYPE
      - GENDER
      - LOCATION
      - PLACEMENT
      - COUNTRY
      - TARGETED_INTEREST
      - PINNER_INTEREST
      - AUDIENCE_INCLUDE
      - GEO
      - AGE_BUCKET
      - REGION
      - QUIZ_RESULT
      - AGE_BUCKET_AND_GENDER
    AdsAnalyticsCampaignTargetingType:
      type: string
      description: Reporting targeting type for campaigns
      example: APPTYPE
      enum:
      - KEYWORD
      - APPTYPE
      - GENDER
      - LOCATION
      - PLACEMENT
      - COUNTRY
      - TARGETED_INTEREST
      - PINNER_INTEREST
      - AUDIENCE_INCLUDE
      - GEO
      - AGE_BUCKET
      - REGION
      - CREATIVE_TYPE
      - AGE_BUCKET_AND_GENDER
      - AUDIENCE_MULTIPLIER
    AdsAnalyticsCreateAsyncRequest:
      type: object
      allOf:
      - type: object
        properties:
          start_date:
            description: 'Metric report start date (UTC). Format: YYYY-MM-DD'
            type: string
            pattern: ^(\d{4})-(\d{2})-(\d{2})$
            example: '2020-12-20'
          end_date:
            description: 'Metric report end date (UTC). Format: YYYY-MM-DD'
            type: string
            pattern: ^(\d{4})-(\d{2})-(\d{2})$
            example: '2020-12-20'
          granularity:
            description: TOTAL - metrics are aggregated over the specified date range.<br>
              DAY - metrics are broken down daily.<br> HOUR - metrics are broken down
              hourly.<br>WEEKLY - metrics are broken down weekly.<br>MONTHLY - metrics
              are broken down monthly
            type: string
            allOf:
            - $ref: '#/components/schemas/Granularity'
          click_window_days:
            description: Number of days to use as the conversion attribution window
              for a pin click action. Applies to Pinterest Tag conversion metrics.
              Prior conversion tags use their defined attribution windows. If not
              specified, defaults to `30` days.
            type: integer
            allOf:
            - $ref: '#/components/schemas/ConversionAttributionWindowDays'
            default: 30
          engagement_window_days:
            description: Number of days to use as the conversion attribution window
              for an engagement action. Engagements include saves, closeups, link
              clicks, and carousel card swipes. Applies to Pinterest Tag conversion
              metrics. Prior conversion tags use their defined attribution windows.
              If not specified, defaults to `30` days.
            type: integer
            allOf:
            - $ref: '#/components/schemas/ConversionAttributionWindowDays'
            default: 30
          view_window_days:
            description: Number of days to use as the conversion attribution window
              for a view action. Applies to Pinterest Tag conversion metrics. Prior
              conversion tags use their defined attribution windows. If not specified,
              defaults to `1` day.
            type: integer
            allOf:
            - $ref: '#/components/schemas/ConversionAttributionWindowDays'
            default: 1
          conversion_report_time:
            description: 'The date by which the conversion metrics returned from this
              endpoint will be reported. There are two dates associated with a conversion
              event: the date that the user interacted with the ad, and the date that
              the user completed a conversion event.'
            type: string
            allOf:
            - $ref: '#/components/schemas/ConversionReportTimeType'
            default: TIME_OF_AD_ACTION
          attribution_types:
            description: List of types of attribution for the conversion report
            type: array
            items:
              $ref: '#/components/schemas/ConversionReportAttributionType'
        required:
        - start_date
        - end_date
        - granularity
      - type: object
        allOf:
        - $ref: '#/components/schemas/CampaignIdFilter'
        - type: object
          properties:
            campaign_statuses:
              type: array
              description: List of status values for filtering
              example:
              - RUNNING
              - PAUSED
              items:
                $ref: '#/components/schemas/CampaignSummaryStatus'
              maxItems: 6
              minItems: 1
        - $ref: '#/components/schemas/CampaignObjectivesFilter'
        - type: object
          properties:
            campaign_brand_label:
              type: string
              description: Campaign brand label for filtering.
              example: Brand
        - $ref: '#/components/schemas/AdGroupIdFilter'
        - type: object
          properties:
            ad_group_statuses:
              type: array
              description: List of values for filtering
              example:
              - RUNNING
              - PAUSED
              items:
                $ref: '#/components/schemas/AdGroupSummaryStatus'
              maxItems: 6
              minItems: 1
        - type: object
          properties:
            ad_ids:
              type: array
              description: List of ad ids [This parameter is no supported for Product
                Item Level Reports]
              example:
              - '12345678'
              items:
                type: string
                pattern: ^\d+$
              maxItems: 500
              minItems: 1
        - type: object
          properties:
            ad_statuses:
              type: array
              description: List of values for filtering [This parameter is not supported
                for Product Item Level Reports]
              example:
              - APPROVED
              - PAUSED
              items:
                $ref: '#/components/schemas/PinPromotionSummaryStatus'
              maxItems: 6
              minItems: 1
        - type: object
          properties:
            product_group_ids:
              type: array
              description: List of product group ids
              example:
              - '12345678'
              items:
                type: string
                pattern: ^\d+$
              maxItems: 500
              minItems: 1
        - type: object
          properties:
            product_group_statuses:
              type: array
              description: List of values for filtering
              example:
              - RUNNING
              - PAUSED
              items:
                $ref: '#/components/schemas/ProductGroupSummaryStatus'
              maxItems: 6
              minItems: 1
        - type: object
          properties:
            product_item_ids:
              type: array
              description: List of product item ids
              example:
              - '12345678'
              items:
                type: string
                pattern: ^\d+$
              maxItems: 500
              minItems: 1
        - $ref: '#/components/schemas/TargetingTypeFilter'
        - type: object
          properties:
            metrics_filters:
              type: array
              description: List of metrics filters
              minItems: 1
              items:
                $ref: '#/components/schemas/AdsAnalyticsMetricsFilter'
      - type: object
        required:
        - level
        - columns
        properties:
          columns:
            description: Metric and entity columns. Pin promotion and ad related columns
              are not supported for the Product Item level reports.
            type: array
            items:
              $ref: '#/components/schemas/ReportingColumnAsync'
          level:
            type: string
            description: Level of the report
            allOf:
            - $ref: '#/components/schemas/MetricsReportingLevel'
            example: CAMPAIGN
          report_format:
            description: Specification for formatting the report data. Reports in
              JSON will not zero-fill metrics, whereas reports in CSV will. Both report
              formats will omit rows where all the columns are equal to 0.
            type: string
            allOf:
            - $ref: '#/components/schemas/DataOutputFormat'
            default: JSON
          primary_sort:
            type: string
            allOf:
            - type: string
              description: Whether to first sort the report by date or by entity ID
                of the reporting entity level. Date will be used as the first level
                key for JSON reports that use BY_DATE. BY_DATE is recommended for
                large requests.
              example: BY_ID
              enum:
              - BY_ID
              - BY_DATE
            default: BY_ID
          start_hour:
            description: Which hour of the start date to begin the report. The entire
              day will be included if no start hour is provided. Only allowed for
              hourly reports.
            type: integer
            minimum: 0
            maximum: 23
          end_hour:
            description: Which hour of the end date to stop the report (inclusive).
              For example, with an end_date of '2020-01-01' and end_hour of '15',
              the report will contain metrics up to '2020-01-01 14:59:59'. The entire
              day will be included if no end hour is provided. Only allowed for hourly
              reports.
            type: integer
            minimum: 0
            maximum: 23
          combine_targeting_types:
            type: boolean
            description: Determines if the targeting types included in the request
              should be consolidated into a single breakdown. For example, when combine_targeting_types
              is set to true, if GENDER and COUNTRY are targeting types in the request,
              the response will have a targeting type of GENDER_AND_COUNTRY and targeting
              values such as female&US. This feature is currently in BETA and is not
              available to all users.
            example: false
            default: false
          reporting_timezone:
            description: Specify the timezone to be applied for the reporting. This
              feature is currently in BETA and is not available to all users.
            allOf:
            - $ref: '#/components/schemas/ReportingTimeZone'
    AdsAnalyticsCreateAsyncResponse:
      type: object
      properties:
        report_status:
          type: string
          allOf:
          - $ref: '#/components/schemas/BulkReportingJobStatus'
        token:
          type: string
        message:
          type: string
          nullable: true
    AdsAnalyticsFilterColumn:
      type: string
      description: Reporting columns for sync reporting data filter
      example: SPEND_IN_DOLLAR
      enum:
      - SPEND_IN_DOLLAR
      - TOTAL_IMPRESSION
    AdsAnalyticsFilterOperator:
      type: string
      description: Filter operator for sync reporting
      example: LESS_THAN
      enum:
      - LESS_THAN
      - GREATER_THAN
    AdsAnalyticsGetAsyncResponse:
      type: object
      properties:
        report_status:
          type: string
          allOf:
          - $ref: '#/components/schemas/BulkReportingJobStatus'
        url:
          type: string
          nullable: true
        size:
          type: number
          nullable: true
    AdsAnalyticsMetricsFilter:
      type: object
      properties:
        field:
          $ref: '#/components/schemas/AdsAnalyticsFilterColumn'
        operator:
          $ref: '#/components/schemas/AdsAnalyticsFilterOperator'
        values:
          type: array
          description: List of values for filtering
          items:
            type: number
          minItems: 1
      required:
      - field
      - operator
      - values
    AdsAnalyticsResponse:
      type: array
      items:
        type: object
        properties:
          AD_ID:
            description: The ID of the ad that this metrics belongs to.
            type: string
            pattern: ^\d+$
          DATE:
            description: Current metrics date. Only returned when granularity is a
              time-based value (`DAY`, `HOUR`, `WEEK`, `MONTH`)
            type: string
            format: date
        required:
        - AD_ID
        additionalProperties: true
        example:
          DATE: '2021-04-01'
          AD_ID: '547602124502'
          SPEND_IN_DOLLAR: 30
          TOTAL_CLICKTHROUGH: 216
    AdsAnalyticsTargetingType:
      type: string
      description: Reporting targeting type
      example: APPTYPE
      enum:
      - KEYWORD
      - APPTYPE
      - GENDER
      - LOCATION
      - PLACEMENT
      - COUNTRY
      - TARGETED_INTEREST
      - PINNER_INTEREST
      - AUDIENCE_INCLUDE
      - GEO
      - AGE_BUCKET
      - REGION
      - AGE_BUCKET_AND_GENDER
    AdsCreditDiscountsResponse:
      type: object
      properties:
        active:
          description: True if the offer code is currently active.
          type: boolean
          example: true
        advertiser_id:
          description: Advertiser ID the offer was applied to.
          type: string
          pattern: ^\d+$
          example: '12312451231'
        discountType:
          description: The type of discount of this credit
          type: string
          nullable: true
          enum:
          - COUPON
          - CREDIT
          - COUPON_APPLIED
          - CREDIT_APPLIED
          - MARKETING_OFFER_CREDIT
          - MARKETING_OFFER_CREDIT_APPLIED
          - GOODWILL_CREDIT
          - GOODWILL_CREDIT_APPLIED
          - INTERNAL_CREDIT
          - INTERNAL_CREDIT_APPLIED
          - PREPAID_CREDIT
          - PREPAID_CREDIT_APPLIED
          - SALES_INCENTIVE_CREDIT
          - SALES_INCENTIVE_CREDIT_APPLIED
          - CREDIT_EXPIRED
          - FUTURE_CREDIT
          - REFERRAL_CREDIT
          - INVOICE_SALES_INCENTIVE_CREDIT
          - INVOICE_SALES_INCENTIVE_CREDIT_APPLIED
          - PREPAID_CREDIT_REFUND
          - null
        discountInMicroCurrency:
          description: "The discount applied in the offer\u2019s currency value."
          type: number
          nullable: true
          example: 125000000
        discountCurrency:
          type: string
          nullable: true
          description: Currency value for the discount.
          example: USD
        title:
          description: Human readable title of the offer code.
          type: string
          nullable: true
          example: Ads Credits
        remainingDiscountInMicroCurrency:
          type: number
          nullable: true
          description: The credits left to spend.
          example: 125000000
    AdsCreditRedeemRequest:
      type: object
      required:
      - offerCodeHash
      - validateOnly
      properties:
        offerCodeHash:
          description: Takes in a SHA256 hash of the offerCode.
          example: 138e9e0ff7e38cf511b880975eb574c09aa9d5e1657590ab0431040da68caa67
          type: string
          pattern: ^[a-z0-9]*$
        validateOnly:
          description: If true, only validate if we can redeem offer code. Otherwise
            it will actually apply the offer code to the account
          example: true
          type: boolean
    AdsCreditRedeemResponse:
      type: object
      properties:
        success:
          description: Returns true if the offer code was successfully applied(validateOnly=false)
            or can be applied(validateOnly=true).
          type: boolean
          example: false
        errorCode:
          description: Error code type if error occurs
          type: integer
          nullable: true
          example: 2708
        errorMessage:
          description: Reason for failure
          type: string
          nullable: true
          example: The offer has already been redeemed by this advertiser
    AdGroupIdFilter:
      type: object
      properties:
        ad_group_ids:
          type: array
          description: List of ad group ids
          example:
          - '12345678'
          items:
            type: string
            pattern: ^\d+$
          maxItems: 500
          minItems: 1
    AgeBucketList:
      title: AgeRange
      type: array
      example:
      - 35-44
      - 50-54
      items:
        type: string
        enum:
        - 18-24
        - 25-34
        - 35-44
        - 45-49
        - 50-54
        - 55-64
        - 65+
    AnalyticsDailyMetrics:
      type: object
      properties:
        data_status:
          $ref: '#/components/schemas/DataStatus'
        date:
          description: 'Metrics date (UTC): YYYY-MM-DD.'
          example: '2019-12-01'
          type: string
        metrics:
          $ref: '#/components/schemas/Metrics'
    AnalyticsMetricsResponse:
      type: object
      properties:
        summary_metrics:
          description: The metric name and value over the requested period for each
            requested metric
          type: object
          additionalProperties:
            type: number
          example:
            CLOSEUP: 1
            CLOSEUP_RATE: 0
            ENGAGEMENT: 1
            ENGAGEMENT_RATE: 0
            IMPRESSION: 240
            OUTBOUND_CLICK: 20
            OUTBOUND_CLICK_RATE: 0.08
            PIN_CLICK: 37
            PIN_CLICK_RATE: 0.15
            PROFILE_VISIT: 0
            QUARTILE_95_PERCENT_VIEW: 8
            SAVE: 20
            SAVE_RATE: 0.18
            VIDEO_10S_VIEW: 2
            VIDEO_AVG_WATCH_TIME: 2507.75
            VIDEO_MRC_VIEW: 20
            VIDEO_START: 29
            VIDEO_V50_WATCH_TIME: 10031
        daily_metrics:
          description: Array with the requested daily metric records
          items:
            $ref: '#/components/schemas/AnalyticsDailyMetrics'
          type: array
    AnalyticsResponse:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/AnalyticsMetricsResponse'
    AssetIdPermissions:
      type: object
      description: An object containing the permissions a business member has on the
        asset.
      properties:
        asset_id:
          description: Unique identifier of a business asset.
          example: '549755885175'
          pattern: ^\d+$
          type: string
          maxLength: 20
          minLength: 1
        asset_type:
          $ref: '#/components/schemas/AssetTypeResponse'
        permissions:
          $ref: '#/components/schemas/PermissionsResponse'
        asset_group_info:
          nullable: true
          description: An object containing all the information specific to the provided
            asset group. This field will be populated only if asset_type equals 'ASSET_GROUP'.
          $ref: '#/components/schemas/AssetGroupBinding'
    AssetIdToPermissions:
      description: |
        An object mapping asset ids to lists of business permissions. This can be used to setting/requesting permissions on various assets. If accepting an invite or request, this object would be used to grant asset permissions to the member or partner.
      type: object
      minProperties: 1
      additionalProperties:
        type: array
        minItems: 1
        maxItems: 50
        items:
          $ref: '#/components/schemas/Permissions'
      example:
        '549760723247':
        - ANALYST
        '549760723248':
        - ANALYST
        - ADMIN
        '809944451643622187':
        - PROFILE_PUBLISHER
    AssetTypeResponse:
      description: Type of asset. Currently we only support AD_ACCOUNT, PROFILE, ASSET_GROUP
        and CATALOG.
      example: AD_ACCOUNT
      type: string
    Audience:
      properties:
        ad_account_id:
          description: Ad account ID.
          example: '549755885175'
          pattern: ^\d+$
          title: ad_account_id
          type: string
        id:
          description: Audience ID.
          example: '1234'
          pattern: ^\d+$
          title: id
          type: string
        name:
          description: Audience name.
          example: ACME Tools
          title: name
          type: string
        audience_type:
          type: string
          description: '<a href="/docs/reference/glossary/#Audience Types">Audience
            types</a>: ACTALIKE, ENGAGEMENT, CUSTOMER_LIST and VISITOR'
          title: audience_type
        description:
          description: Audience description.
          example: People who love making quilts.
          nullable: true
          title: description
          type: string
        rule:
          $ref: '#/components/schemas/AudienceRule'
        size:
          description: Audience size.
          example: 1000
          nullable: true
          title: size
          type: integer
        status:
          type: string
          description: Audience status. READY, INITIALIZING, TOO_SMALL - Each audience
            list needs to have at least 100 people with Pinterest accounts before
            you can start using it.
          title: status
        type:
          description: Always "audience".
          example: audience
          title: type
          type: string
        created_timestamp:
          description: Creation time. Unix timestamp in seconds.
          example: 1451431341
          nullable: true
          title: created_time
          type: integer
        updated_timestamp:
          description: Last update time. Unix timestamp in seconds.
          example: 1451431341
          nullable: true
          title: updated_time
          type: integer
        created_by_company_name:
          description: The company that created this audience.
          example: Pinterest
          nullable: true
          title: created_by_company_name
          type: string
      title: Audience
      type: object
    AudienceCategory:
      title: AudienceCategory
      type: object
      properties:
        key:
          title: key
          description: Interest unique key (same as ID).
          type: string
          example: '1234567'
        name:
          title: name
          description: Interest name.
          type: string
          example: travel
        ratio:
          title: ratio
          description: Interest's percent of category's total audience.
          type: number
          example: 0.551
        index:
          title: index
          description: Interest affinity index.
          type: number
          example: 1.2
        id:
          title: id
          description: Interest ID.
          type: string
          example: '1234567'
        subcategories:
          title: subcategories
          description: Subcategory interest distribution
          type: array
          items:
            title: AudienceSubcategory
            type: object
            properties:
              key:
                title: key
                description: Interest unique key (same as ID).
                type: string
                example: '958862518888'
              name:
                title: name
                description: Subinterest name.
                type: string
                example: travel destinations
              ratio:
                title: ratio
                description: Subinterest's percent of category's total audience.
                type: number
                example: 0.482
              index:
                title: index
                description: Subinterest affinity index.
                type: number
                example: 1.2
              id:
                title: id
                description: Subinterest ID.
                type: string
                example: '958862518888'
    AudienceCommon:
      title: AudienceCommon
      type: object
      properties:
        ad_account_id:
          title: ad_account_id
          description: Ad account ID.
          type: string
          example: '549755885175'
          pattern: ^\d+$
        name:
          title: name
          description: Audience name.
          type: string
          example: string
        rule:
          $ref: '#/components/schemas/AudienceRule'
    AudienceCreateCustomRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/AudienceCommon'
      - title: AudienceCreateCustomRequest
        required:
        - sharing_type
        - name
        - rule
        - data_party
        properties:
          sharing_type:
            $ref: '#/components/schemas/AudienceSharingType'
          data_party:
            $ref: '#/components/schemas/AudienceDataParty'
          category:
            type: string
            example: DLX Demographics
    AudienceCreateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/AudienceCommon'
      - title: AudienceCreateRequest
        required:
        - audience_type
        - name
        - rule
        properties:
          description:
            $ref: '#/components/schemas/AudienceDescription'
          audience_type:
            type: string
            title: audience_type
            description: '<a href="/docs/reference/glossary/#Audience Types">Audience
              types</a>: ACTALIKE, ENGAGEMENT, CUSTOMER_LIST and VISITOR. Values are
              case-sensitive.'
            allOf:
            - $ref: '#/components/schemas/AudienceType'
    AudienceDataParty:
      description: Whether the data is owned by the partner (1p) or by the data provider
        (3p)
      type: string
      enum:
      - 1p
      - 3p
    AudienceDefinition:
      title: AudienceDefinition
      description: Queryable audience representation.
      type: object
      properties:
        date:
          title: date
          description: Generation date
          type: string
          nullable: true
          example: '2022-10-09'
        type:
          title: AudienceDefinitionType
          type: string
          example: IMPRESSION_PLUS_ENGAGEMENT
        scope:
          title: AudienceDefinitionScope
          type: string
          example: PARTNER
    AudienceDefinitionResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AudienceDefinition'
    AudienceDefinitionScope:
      type: object
      description: Generated audience scope to request.
      properties:
        scope:
          type: string
          enum:
          - PARTNER
          - PINTEREST
    AudienceDefinitionType:
      type: object
      description: Generated audience type to request.
      properties:
        scope:
          type: string
          enum:
          - IMPRESSION_PLUS_ENGAGEMENT
          - ENGAGEMENT
    AudienceDemographicValue:
      title: AudienceDemographicValue
      description: Demographic detail for a single audience demographic
      type: object
      properties:
        key:
          title: key
          description: Unique key for demographic item
          type: string
          example: us
        name:
          title: name
          description: Display name for demographic
          type: string
          example: United States
        ratio:
          title: ratio
          description: Value of demographic item as a percent of total audience
          type: number
          example: 0.551
      example:
        name: United States
        key: us
        ratio: 0.551
    AudienceDemographics:
      title: AudienceDemographics
      description: Audience demographics
      type: object
      properties:
        ages:
          title: ages
          description: Ages distribution.
          type: array
          items:
            $ref: '#/components/schemas/AudienceDemographicValue'
        genders:
          title: genders
          description: Gender distribution.
          type: array
          items:
            $ref: '#/components/schemas/AudienceDemographicValue'
        devices:
          title: devices
          description: Device usage distribution.
          type: array
          items:
            $ref: '#/components/schemas/AudienceDemographicValue'
        metros:
          title: metros
          description: Geographic metro area distribution.
          type: array
          items:
            $ref: '#/components/schemas/AudienceDemographicValue'
        countries:
          title: countries
          description: Country area distribution.
          type: array
          items:
            $ref: '#/components/schemas/AudienceDemographicValue'
    AudienceDescription:
      title: description
      description: Audience description.
      type: string
      example: string
    AudienceInsightCategoryArrayResponse:
      deprecated: true
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AudienceInsightCategoryCommon'
    AudienceInsightCategoryCommon:
      deprecated: true
      type: object
      properties:
        key:
          example: '549755885175'
          type: string
        name:
          example: travel
          type: string
        ratio:
          example: 0.551
          type: number
        index:
          example: 1.2
          type: number
        id:
          example: '549755885175'
          type: string
    AudienceInsightType:
      default: YOUR_TOTAL_AUDIENCE
      type: string
      example: YOUR_TOTAL_AUDIENCE
      enum:
      - YOUR_TOTAL_AUDIENCE
      - YOUR_ENGAGED_AUDIENCE
      - PINTEREST_TOTAL_AUDIENCE
    AudienceInsightsResponse:
      title: AudienceInsightsResponse
      description: Audience interests and demographics.
      type: object
      properties:
        categories:
          title: categories
          description: Category interest distribution
          type: array
          items:
            $ref: '#/components/schemas/AudienceCategory'
        demographics:
          $ref: '#/components/schemas/AudienceDemographics'
        type:
          $ref: '#/components/schemas/AudienceInsightType'
        date:
          title: date
          description: Generation date
          type: string
          nullable: true
          example: '2022-10-09'
          pattern: ^\d{4}-\d{2}-\d{2}$
        size:
          title: size
          description: Population count.
          type: integer
          example: 10000
        size_is_upper_bound:
          title: size_is_upper_bound
          description: Indicates whether the audience size has been rounded up to
            the next highest upper boundary.
          type: boolean
          example: true
    AudienceRule:
      description: 'JSON object defining targeted audience users. Example rule formats
        per audience type:<br>CUSTOMER_LIST: { "customer_list_id": "&lt;customer list
        ID&gt;"}<br>ACTALIKE: { "seed_id": ["&lt;audience ID&gt;"], "country": "US",
        "percentage": "10" }<br>(Valid countries include: "US", "CA", and "GB". Percentage
        should be 1-10.<br>The targeted audience should be this % size across Pinterest.)<br>VISITOR:
        { "visitor_source_id": ["&lt;conversion tag ID&gt;"], "retention_days": "180",
        "event_source": {"=": ["web", "mobile"]}, "ingestion_source": {"=": ["tag"]}}<br>(Retention
        days should be 1-540. Retention applies to specific customers.)<br>ENGAGEMENT:
        {"engagement_domain": ["www.entomi.com"], "engager_type": 1}<br>For more details
        on engagement audiences, see <a href="/docs/redoc/adtech_ads_v4/#section/November-2021"
        target="_blank">November 2021 changelog</a>.'
      properties:
        country:
          description: 'Valid countries include: "US", "CA", and "GB".'
          example: US
          title: country
          type: string
        customer_list_id:
          description: Customer list ID. For CUSTOMER_LIST `audience_type`.
          example: '5497558859876'
          pattern: ^\d+$
          title: customer_list_id
          type: string
        engagement_domain:
          description: The audience account's verified domain. **Required** for ENGAGEMENT
            `audience_type`.
          example:
          - www.somedomain.com
          items:
            type: string
          title: engagement_domain
          type: array
        engagement_type:
          description: 'Engagement type enum. Optional for ENGAGEMENT `audience_type`.
            Supported values are `click`, `save`, `closeup`, `comment` and `like`.
            All engagements are included if this field is not set. '
          example: click
          title: engagement_type
          type: string
        event:
          description: A Pinterest tag event. Optional for VISITOR `audience_type`.
            Possible values are `pagevisit`, `signup`, `checkout`, `viewcategory`,
            `search`, `addtocart`, `watchvideo`, `lead`, and `custom`. This field
            also accepts a partner-defined Pinterest tag event.
          example: checkout
          title: event
          type: string
        event_data:
          description: "Optional for VISITOR `audience_type`. With the Pinterest tag,\
            \ you can use event data to capture event details from your website. This\
            \ object lists all the available predefined event data fields in the Pinterest\
            \ tag. You can include these event data fields as part of a VISITOR audience\u2019\
            \ s `rule`; however, you **must** specify an `event` for the `event_data`\
            \ fields to be evaluated. Besides what\u2019s listed, you can also create\
            \ your own set of `event_data` fields and define their usages or purposes\
            \ according to your website needs. However, the benefit of using the predefined\
            \ event data fields is that we can provide various metrics based on those\
            \ fields' data.<br>Examples per `event` type:<br>`pagevisit`<br>\"event_data\"\
            : { \"page_name\": \"My online store 123 | view items | shoe\" }<br>`signup`<br>\"\
            event_data\": { \"lead_type\": \"New release promotion\" }<br>`checkout`<br>\"\
            event_data\": { \"value\": 116, \"order_quantity\": 2, \"currency\": \"\
            USD\", \"line_items\": [ { \"product_name\": \"Pillows (Set of 2)\", \"\
            product_id\": \"11\", \"product_price\": 48, \"product_quantity\": 1 },\
            \ { \"product_name\": \"Pillows, Large (Set of 2)\", \"product_id\": \"\
            15\", \"product_price\": 68, \"product_quantity\": 1 } ] }<br>`addtocart`<br>\"\
            event_data\": { \"value\": 499, \"order_quantity\": 1, \"currency\": \"\
            USD\", \"line_items\": [ { \"product_name\": \"Red leather boots\", \"\
            product_id\": \"3486\", \"product_category\": \"shoe\", \"product_variant_id\"\
            : \"JB11103000\", \"product_price\": 499, \"product_quantity\": \"1\"\
            \ , \"product_brand\": \"My brand\" }]}<br>`watchvideo`<br>\"event_data\"\
            : { \"video_title\": \"My Product Video 01\" }<br>`lead`<br>\"event_data\"\
            : { \"lead_type\": \"Newsletter\" }"
          properties:
            currency:
              $ref: '#/components/schemas/Currency'
            lead_type:
              description: Promotion code. For example, "Newsletter".
              example: Newsletter
              title: lead_type
              type: string
            line_items:
              properties:
                product_brand:
                  description: Product brand. For example, "Parker".
                  example: Parker
                  title: product_brand
                  type: string
                product_category:
                  description: Product category. For example, "Shoes".
                  example: Shoes
                  title: product_category
                  type: string
                product_id:
                  description: Product ID. For example, 1414.
                  example: 1414
                  title: product_id
                  type: integer
                product_name:
                  description: Product name. For example, "Parker Boots".
                  example: Parker Boots
                  title: product_name
                  type: string
                product_price:
                  description: Product price. For example, "99.99".
                  example: '99.99'
                  title: product_price
                  type: string
                product_quantity:
                  description: Product quantity. For example, 2.
                  example: 2
                  title: product_quantity
                  type: integer
                product_variant:
                  description: Product variant. For example, "Red".
                  example: Red
                  title: product_variant
                  type: string
                product_variant_id:
                  description: Product variant ID. For example, "1414-34832".
                  example: 1414-34832
                  title: product_variant_id
                  type: string
              title: LineItem
              type: object
            order_id:
              description: Order ID. For example, "X-151481".
              example: X-151481
              title: order_id
              type: string
            order_quantity:
              description: Order quantity. For example, 1.
              example: 1
              title: order_quantity
              type: integer
            page_name:
              description: Page name. For example, "Our Favorite Pins on Pinterest".
              example: Our Favorite Pins on Pinterest.
              title: page_name
              type: string
            promo_code:
              description: Promotion code. For example, "WINTER10".
              example: WINTER10
              title: promo_code
              type: string
            property:
              description: Property. For example, "Athleta".
              example: Athleta
              title: property
              type: string
            search_query:
              description: Search query string. For example, "boots".
              example: boots
              title: search_query
              type: string
            value:
              description: Product value. For example, "199.98"
              example: '199.98'
              title: value
              type: string
            video_title:
              description: Video title. For example, "How to style your Parker Boots".
              example: How to style your Parker Boots
              title: video_title
              type: string
          title: PinterestTagEventData
          type: object
        percentage:
          description: Percentage should be 1-10. The targeted audience should be
            this % size across Pinterest.
          example: 3
          title: percentage
          type: integer
        pin_id:
          description: 'IDs of engaged organic pins. Optional for ENGAGEMENT `audience_type`.
            For example, "pin_id:": ["34567"]'
          example:
          - '34567'
          items:
            pattern: ^\d+$
            type: string
          title: pin_id
          type: array
        prefill:
          description: Optional for VISITOR `audience_type`. If `true`, the specified
            rule on existing engagement data is applied to pre-populate the audience.
            If `false`, the audience is empty at creation time. The default is `true`.
          example: true
          title: prefill
          type: boolean
        retention_days:
          description: Number of days a Pinterest user remains in the audience. Optional
            for ENGAGEMENT and VISITOR `audience_type`. Accepted range is 1-540. Defaults
            to 180 if not specified.
          example: 30
          title: retention_days
          type: integer
        seed_id:
          description: 'Audience ID(s). For ACTALIKE `audience_type`. '
          example:
          - '2542620639259'
          - '2542620639261'
          items:
            pattern: ^\d+$
            type: string
          title: seed_id
          type: array
        url:
          description: 'Optional for ENGAGEMENT or VISITOR `audience_type`. For ENGAGEMENT,
            it is the engaged pin''s URL. For VISITOR, you can use it as a string
            or a {operator: value} object for filtering visitors based on conversion
            tag event URLs. Supported operators are [ =, !=, contains, not_contains].<br>Example
            1:  "url": "http://www.myonlinestore123.com/view_item/shoe"<br>Example
            2: "url": {"contains": "/view_item/shoe"}'
          items:
            type: string
          title: url
          type: array
        visitor_source_id:
          description: The conversion tag ID, or the Pinterest tag ID, that you use
            on your website. For VISITOR `audience_type`.
          example: '549755885175'
          pattern: ^\d+$
          title: visitor_source_id
          type: string
        event_source:
          description: 'Optional for VISITOR. You can use it as a {''='': [value]}.
            Supported values are: web, mobile, offline'
          example:
            '=':
            - web
            - mobile
          title: event_source
          type: object
        ingestion_source:
          description: 'Optional for VISITOR. You can use it as a {''='': [value]}.
            Supported values are: tag, mmp, file_upload, conversions_api'
          example:
            '=':
            - tag
          title: ingestion_source
          type: object
        engager_type:
          description: Optional for ENGAGEMENT. Engager type value should be 1-2.
          example: 1
          title: engager_type
          type: integer
        campaign_id:
          description: Campaign ID for engagement audience filter.
          example:
          - '626744528398'
          items:
            pattern: ^\d+$
            type: string
          title: campaign_id
          type: array
        ad_id:
          description: Ad ID for engagement audience filter.
          example:
          - '687201361754'
          items:
            pattern: ^\d+$
            type: string
          title: ad_id
          type: array
        objective_type:
          description: Objective for engagement audience filter.
          example:
          - AWARENESS
          items:
            $ref: '#/components/schemas/ObjectiveType'
          title: objective_type
          type: array
        ad_account_id:
          description: Ad account ID.
          example: '549755885175'
          pattern: ^\d+$
          title: ad_account_id
          type: string
      title: Rule
      type: object
    AudienceShareType:
      type: string
      default: SHARED
      enum:
      - SHARED
      - RECEIVED
    AudienceAccountType:
      type: string
      default: AD_ACCOUNT
      enum:
      - AD_ACCOUNT
      - BUSINESS_ACCOUNT
    AudienceSharingType:
      description: 'Audience sharing type: ["CUSTOM", "SYNDICATED"]'
      type: string
      enum:
      - CUSTOM
      - SYNDICATED
    AudienceType:
      description: Audience type
      enum:
      - CUSTOMER_LIST
      - VISITOR
      - ENGAGEMENT
      - ACTALIKE
      - PERSONA
      example: ACTALIKE
      title: AudienceType
      type: string
    AudienceUpdateOperationType:
      title: operation_type
      type: string
      description: Audience operation type (update or remove).
      example: UPDATE
      default: UPDATE
      enum:
      - UPDATE
      - REMOVE
    AudienceUpdateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/AudienceCommon'
      - title: AudienceUpdateRequest
        type: object
        properties:
          description:
            $ref: '#/components/schemas/AudienceDescription'
          operation_type:
            $ref: '#/components/schemas/AudienceUpdateOperationType'
    AuthRespondInvitesBody:
      description: An object with a list of all the invites the user would like to
        respond to and the action to take.
      type: object
      required:
      - invites
      properties:
        invites:
          type: array
          minItems: 1
          maxItems: 100
          items:
            properties:
              action:
                type: object
                properties:
                  accept_invite:
                    description: Whether the invite/request is accepted.
                    type: boolean
                  asset_id_to_permissions:
                    $ref: '#/components/schemas/AssetIdToPermissions'
                required:
                - accept_invite
              invite_id:
                description: Unique identifier of an invite.
                pattern: ^\d+$
                type: string
                minLength: 1
                maxLength: 25
            required:
            - invite_id
            - action
            type: object
    AvailabilityFilter:
      type: object
      title: AVAILABILITY
      additionalProperties: false
      properties:
        AVAILABILITY:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringCriteria'
      required:
      - AVAILABILITY
    BaseInviteDataResponse:
      type: object
      nullable: true
      properties:
        id:
          type: string
          description: Unique identifier of the invite/request.
          example: '383791336903426391'
          pattern: ^\d+$
        invite_data:
          type: object
          description: Metadata for the invite/request.
          properties:
            invite_expiration:
              type: integer
              description: The date and time when the invite/request will expire.
                Returned in milliseconds.
              example: 1709748104775
            invite_status:
              type: string
              description: The current status of the invite. The invite can be in
                one of the following states PENDING, ACCEPTED, DECLINED, CANCELLED,
                EXPIRED.
              example: PENDING
            invite_type:
              type: string
              description: The type of invite. <br>'MEMBER_INVITE' is to invite a
                member to access your business assets. <br>'PARTNER_INVITE' is to
                invite a partner to access your business assets. <br>'PARTNER_REQUEST'
                is to request access a partner's business assets.
              example: MEMBER_INVITE
            last_updated_time:
              type: integer
              description: The date and time the invite/request was last updated.
                Returned in milliseconds.
              example: 1646767577816
            sent_at:
              type: integer
              description: The date and time the invite/request was sent/created.
                Returned in milliseconds.
              example: 1646767577816
        is_received_invite:
          type: boolean
          description: Indicates whether the invite/request was received.
        user:
          type: object
          description: Metadata for the member/partner that was sent the invite/request.
          allOf:
          - $ref: '#/components/schemas/BusinessAccessUserSummary'
    BatchOperation:
      description: The operation performed by the batch. The DELETE_DISCONTINUED operation
        only updates availablity to "Out of Stock".
      example: UPDATE
      type: string
      enum:
      - UPDATE
      - UPSERT
      - CREATE
      - DELETE_DISCONTINUED
      - DELETE
    BatchOperationStatus:
      description: The status of the operation performed by the batch
      example: PROCESSING
      type: string
      enum:
      - PROCESSING
      - COMPLETED
      - FAILED
    BidFloor:
      example:
        bid_floors:
        - 100000
        - 200000
        type: bidfloor
      properties:
        bid_floors:
          description: A list of bid floors in micro currency. For example, [100000,
            200000]
          example:
          - 100000
          - 200000
          items:
            type: integer
          title: bid_floors
          type: array
        type:
          default: bidfloor
          description: Always the string 'bidfloor'
          example: bidfloor
          title: type
          type: string
      title: BidFloor
      type: object
    BidFloorRequest:
      example:
        targeting_spec:
          GEO:
          - BE-VOV
          LOCATION:
          - US
          LOCALE:
          - cs
          AGE_BUCKET:
          - 25-34
          AUDIENCE_INCLUDE:
          - '2542620905473'
          SHOPPING_RETARGETING:
          - lookback_window: 30
            exclusion_window: 14
            tag_types:
            - 0
            - 6
          - lookback_window: 30
            exclusion_window: 14
            tag_types:
            - 0
            - 6
          GENDER:
          - male
          TARGETING_STRATEGY:
          - CHOOSE_YOUR_OWN
          APPTYPE:
          - iphone
          AUDIENCE_EXCLUDE:
          - '2542620905475'
          INTEREST:
          - '925056443165'
        bid_floor_specs:
        - billable_event: CLICKTHROUGH
          creative_type: REGULAR
          currency: USD
          countries:
          - US
          - US
          optimization_goal_metadata:
            frequency_goal_metadata:
              timerange: DAY
              frequency: 5
            conversion_tag_v3_goal_metadata:
              attribution_windows:
                view_window_days: 1
                click_window_days: 0
                engagement_window_days: 6
              conversion_tag_id: '123456789'
              learning_mode_type: ACTIVE
              conversion_event: PAGE_VISIT
              is_roas_optimized: true
              cpa_goal_value_in_micro_currency: '123456789'
            scrollup_goal_metadata:
              scrollup_goal_value_in_micro_currency: '123456789'
        - billable_event: CLICKTHROUGH
          creative_type: REGULAR
          currency: USD
          countries:
          - US
          - US
          optimization_goal_metadata:
            frequency_goal_metadata:
              timerange: DAY
              frequency: 5
            conversion_tag_v3_goal_metadata:
              attribution_windows:
                view_window_days: 1
                click_window_days: 0
                engagement_window_days: 6
              conversion_tag_id: '123456789'
              learning_mode_type: ACTIVE
              conversion_event: PAGE_VISIT
              is_roas_optimized: true
              cpa_goal_value_in_micro_currency: '123456789'
            scrollup_goal_metadata:
              scrollup_goal_value_in_micro_currency: '123456789'
      properties:
        bid_floor_specs:
          items:
            example:
              billable_event: CLICKTHROUGH
              creative_type: REGULAR
              currency: USD
              countries:
              - US
              - US
              optimization_goal_metadata:
                frequency_goal_metadata:
                  timerange: DAY
                  frequency: 5
                conversion_tag_v3_goal_metadata:
                  attribution_windows:
                    view_window_days: 1
                    click_window_days: 0
                    engagement_window_days: 6
                  conversion_tag_id: '123456789'
                  learning_mode_type: ACTIVE
                  conversion_event: PAGE_VISIT
                  is_roas_optimized: true
                  cpa_goal_value_in_micro_currency: '123456789'
                scrollup_goal_metadata:
                  scrollup_goal_value_in_micro_currency: '123456789'
            properties:
              countries:
                items:
                  $ref: '#/components/schemas/Country'
                title: countries
                type: array
              currency:
                $ref: '#/components/schemas/Currency'
              objective_type:
                $ref: '#/components/schemas/ObjectiveType'
              billable_event:
                $ref: '#/components/schemas/ActionType'
              optimization_goal_metadata:
                $ref: '#/components/schemas/OptimizationGoalMetadata'
              creative_type:
                $ref: '#/components/schemas/CreativeType'
            required:
            - billable_event
            - currency
            title: BidFloorSpec
            type: object
          title: bid_floor_specs
          type: array
        targeting_spec:
          $ref: '#/components/schemas/TargetingSpec'
      required:
      - bid_floor_specs
      title: BidFloorBody
      type: object
    BillingProfilesResponse:
      type: object
      properties:
        id:
          description: Billing ID.
          type: string
          pattern: ^\d+$
          example: '12312451231'
        card_type:
          description: Type of the card.
          type: string
          enum:
          - UNKNOWN
          - VISA
          - MASTERCARD
          - AMERICAN_EXPRESS
          - DISCOVER
          - ELO
          example: VISA
        status:
          description: Status of the billing.
          type: string
          enum:
          - UNSPECIFIED
          - VALID
          - INVALID
          - PENDING
          - DELETED
          - SECONDARY
          - PENDING_SECONDARY
          example: INVALID
        advertiser_id:
          description: Advertiser ID of the billing.
          type: string
          pattern: ^\d+$
          example: '12312451231'
        payment_method_brand:
          description: Brand of the payment method.
          type: string
          enum:
          - UNKNOWN
          - VISA
          - MASTERCARD
          - AMERICAN_EXPRESS
          - DISCOVER
          - SOFORT
          - DINERS_CLUB
          - ELO
          - CARTE_BANCAIRE
          example: VISA
        billing_type:
          description: Billing type of the advertiser
          type: string
          enum:
          - CREDIT_CARD
          - INVOICE
          - INTERNAL
          - RECURRING
          - PREPAID
          example: CREDIT_CARD
    BillingInvoiceResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the billing invoice
          pattern: ^\d+$
        ad_account_id:
          type: string
          description: The ID of the ad account this invoice belongs to
          pattern: ^\d+$
        ad_account_name:
          type: string
          description: The name of the ad account this invoice belongs to
        document_type:
          type: string
          description: The type of the document
          enum:
          - INVOICE
          - CREDIT_MEMO
        amount_billed_micro_currency:
          type: integer
          description: The amount billed in this invoice. Denoted in micro currency
        amount_tax_micro_currency:
          type: integer
          description: The tax in this invoice. Denoted in micro currency
          nullable: true
        amount_net_micro_currency:
          type: integer
          description: The net amount in this invoice. Denoted in micro currency
          nullable: true
        amount_discount_micro_currency:
          type: integer
          description: The discount in this invoice. Denoted in micro currency
          nullable: true
        currency:
          $ref: '#/components/schemas/Currency'
        billing_period_start_date:
          type: string
          format: date
          description: 'The start date of the billing period. Format: YYYY-MM-DD'
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
        billing_period_end_date:
          type: string
          format: date
          description: 'The end date of the billing period. Format: YYYY-MM-DD'
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
        invoice_due_date:
          type: string
          format: date
          description: 'The date the invoice is due. Format: YYYY-MM-DD'
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
        status:
          type: string
          description: The status of the invoice
          example: OPEN
          enum:
          - OPEN
          - CLOSED
        payment_terms:
          type: string
          description: The payment terms of the invoice
          example: NET 30
        bill_to_country:
          type: string
          description: The country of the bill to address
    BillingInvoiceDownloadResponse:
      title: BillingInvoiceDownloadResponse
      type: object
      properties:
        id:
          type: string
          description: The billing invoice id
        download_url:
          type: string
          description: The download url for the billing invoice
    Board:
      title: Board
      description: Board
      type: object
      properties:
        id:
          type: string
          readOnly: true
          example: '549755885175'
        created_at:
          type: string
          description: Date and time of board creation.
          readOnly: true
          format: date-time
          example: '2020-01-01T20:10:40-00:00'
        board_pins_modified_at:
          type: string
          description: Date and time of last board pins modified.
          readOnly: true
          format: date-time
          example: '2020-01-01T20:10:40-00:00'
        name:
          description: |-
            Name of the board.

            <strong>Note: </strong>If you create an ad-only board by setting `is_ads_only` to `true`, the board name automatically becomes "Ad-only Pins".
          type: string
          example: Summer Recipes
        description:
          type: string
          nullable: true
          example: My favorite summer recipes
        collaborator_count:
          type: integer
          description: Count of collaborators on the board.
          minimum: 0
          readOnly: true
          example: 17
        pin_count:
          type: integer
          description: Count of pins on the board.
          minimum: 0
          readOnly: true
          example: 5
        follower_count:
          type: integer
          description: Board follower count.
          readOnly: true
          minimum: 0
          example: 13
        media:
          type: object
          readOnly: true
          description: Board media.
          properties:
            image_cover_url:
              type: string
              nullable: true
              description: Board cover image.
              example: https://i.pinimg.com/400x300/fd/cd/d5/fdcdd5a6d8a80824add0d054125cd957.jpg
            pin_thumbnail_urls:
              type: array
              description: Board pin thumbnail urls.
              items:
                type: string
              example:
              - https://i.pinimg.com/150x150/b4/57/10/b45710f1ede96af55230f4b43935c4af.jpg
              - https://i.pinimg.com/150x150/dd/ff/46/ddff4616e39c1935cd05738794fa860e.jpg
              - https://i.pinimg.com/150x150/84/ac/59/84ac59b670ccb5b903dace480a98930c.jpg
              - https://i.pinimg.com/150x150/4c/54/6f/4c546f521be85e30838fb742bfff6936.jpg
        owner:
          allOf:
          - $ref: '#/components/schemas/BoardOwner'
          type: object
          readOnly: true
        privacy:
          type: string
          default: PUBLIC
          description: |-
            Privacy setting for a board. Learn more about <a href="https://help.pinterest.com/en/article/secret-boards">secret boards</a> and <a href="https://help.pinterest.com/en/business/article/protected-boards">protected boards</a>
            <strong>Note: </strong>If you create an ad-only board by setting `is_ads_only` to `true`, the `privacy` settng automatically becomes `PROTECTED`.
          enum:
          - PUBLIC
          - PROTECTED
          - SECRET
        is_ads_only:
          description: |-
            If set to `true`, the board will be ad-only and can store ad-only Pins.

            You can only create one ad-only board for any client ID. If you attempt to create another, the system reuses the existing board rather than creating a new one.
          type: boolean
          default: false
          example: true
      required:
      - name
    BoardOwner:
      title: Board owner
      type: object
      properties:
        username:
          type: string
          readOnly: true
    BoardSection:
      title: Board section
      description: Sections help organize pins within a board.
      type: object
      properties:
        id:
          type: string
          readOnly: true
          example: '549755885175'
        name:
          type: string
          example: Salads
          minLength: 1
          maxLength: 180
      required:
      - name
    BoardUpdate:
      title: BoardUpdate
      description: Board fields for updates
      type: object
      properties:
        name:
          type: string
          example: Summer Recipes
        description:
          type: string
          nullable: true
          example: My favorite summer recipes
        privacy:
          type: string
          enum:
          - PUBLIC
          - SECRET
    BookClosedResponse:
      title: BookClosed
      description: Creation fields
      type: object
      properties:
        conversion_metrics_ready:
          title: conversion_metrics_ready
          description: Are conversion metrics ready?
          type: boolean
          example: false
        non_conversion_metrics_ready:
          title: non_conversion_metrics_ready
          description: Are non-conversion metrics ready?
          type: boolean
          example: false
    BrandFilter:
      type: object
      title: BRAND
      additionalProperties: false
      properties:
        BRAND:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringCriteria'
      required:
      - BRAND
    BudgetType:
      description: Budget type. If DAILY, an ad group's daily spend will not exceed
        the budget parameter value. If LIFETIME, the end_time parameter is **REQUIRED**,
        and the ad group spend is spread evenly between the ad group `start_time`
        and `end_time` range. A CBO campaign automatically generates ad group budgets
        from its campaign budget to maximize campaign outcome. For CBO campaigns,
        only "CBO_ADGROUP" is allowed. For WEB_SESSIONS campaigns, only "LIFETIME"
        is allowed. For update, only draft ad groups may update budget type.
      example: DAILY
      enum:
      - DAILY
      - LIFETIME
      - CBO_ADGROUP
      type: string
    BulkDownloadRequest:
      type: object
      description: Ad entities to get in bulk request.
      properties:
        entity_types:
          type: array
          items:
            type: string
            allOf:
            - $ref: '#/components/schemas/BulkEntityType'
          minItems: 1
          maxItems: 5
          description: All entity types specified will be downloaded. Fewer types
            result in faster downloads.
          example:
          - CAMPAIGN
          - AD_GROUP
        entity_ids:
          type: array
          items:
            type: string
            pattern: ^\d+$
          description: All entities specified by these IDs as well as their children
            and grandchildren will be downloaded if the entity type is one of the
            types requested to be downloaded.
        updated_since:
          type: string
          pattern: ^\d+$
          example: '1622848072'
          description: Unix UTC timestamp to retrieve all entities that have changed
            since this time.
        campaign_filter:
          type: object
          properties:
            start_time:
              type: string
              pattern: ^\d+$
              example: '1622848072'
              description: Unix UTC timestamp.
            end_time:
              type: string
              pattern: ^\d+$
              example: '1622848072'
              description: Unix UTC timestamp.
            name:
              type: string
              example: campaign name
              description: Campaign name
            campaign_status:
              type: array
              items:
                $ref: '#/components/schemas/CampaignSummaryStatus'
            objective_type:
              type: array
              items:
                $ref: '#/components/schemas/ObjectiveType'
        output_format:
          type: string
          allOf:
          - $ref: '#/components/schemas/BulkOutputFormat'
          default: JSON
    BulkDownloadResponse:
      type: object
      example:
        request_id: '2680059592705'
      properties:
        request_id:
          description: ID of the bulk request.
          example: '2680059592705'
          type: string
    BulkEntityType:
      type: string
      description: Refers ads entity type
      example: AD
      enum:
      - CAMPAIGN
      - AD_GROUP
      - PRODUCT_GROUP
      - AD
      - KEYWORD
      - LABEL
    BulkOutputFormat:
      type: string
      description: Bulk file output format
      enum:
      - CSV
      - JSON
    BulkReportingJobStatus:
      type: string
      description: Possible status for a bulk reporting job
      example: FINISHED
      enum:
      - DOES_NOT_EXIST
      - FINISHED
      - IN_PROGRESS
      - EXPIRED
      - FAILED
      - CANCELLED
    BulkUpsertRequest:
      type: object
      description: Two set of objects to be managed asyncronusly by bulk. One for
        creations, one for modifications.
      properties:
        create:
          $ref: '#/components/schemas/BulkUpsertRequestCreate'
        update:
          $ref: '#/components/schemas/BulkUpsertRequestUpdate'
    BulkUpsertRequestCreate:
      type: object
      description: Request for creation of entities in bulk.
      properties:
        campaigns:
          type: array
          items:
            $ref: '#/components/schemas/CampaignCreateRequest'
        ad_groups:
          type: array
          items:
            $ref: '#/components/schemas/AdGroupCreateRequest'
        ads:
          type: array
          items:
            $ref: '#/components/schemas/AdCreateRequest'
        product_groups:
          type: array
          items:
            $ref: '#/components/schemas/ProductGroupPromotionCreateRequest'
        keywords:
          type: array
          items:
            $ref: '#/components/schemas/KeywordsRequest'
        labels:
          type: array
          items:
            $ref: '#/components/schemas/LabelCreateRequest'
    BulkUpsertRequestUpdate:
      type: object
      description: Request for creation of entities in bulk.
      properties:
        campaigns:
          type: array
          items:
            $ref: '#/components/schemas/CampaignUpdateRequest'
        ad_groups:
          type: array
          items:
            $ref: '#/components/schemas/AdGroupUpdateRequest'
        ads:
          type: array
          items:
            $ref: '#/components/schemas/AdUpdateRequest'
        product_groups:
          type: array
          items:
            $ref: '#/components/schemas/ProductGroupPromotionUpdateRequest'
        keywords:
          type: array
          items:
            $ref: '#/components/schemas/KeywordUpdate'
        labels:
          type: array
          items:
            title: LabelBulkUpdateRequest
            type: object
            properties:
              id:
                description: Label ID.
                example: '1106385754497'
                title: id
                type: string
              value:
                type: string
                maxLength: 100
                description: Label name. 100-character limit.
              status:
                $ref: '#/components/schemas/LabelStatus'
            required:
            - id
    BulkUpsertResponse:
      description: ID of the bulk request.
      type: object
      properties:
        request_id:
          type: string
          example: 549763856477-1660864560-1407e16a-c586-4add-94df-d0b160bec0ff, 549763856477-1660864560-d0b160bec0ff
    BulkUpsertStatus:
      type: string
      enum:
      - RUNNING
      - SUCCEEDED
      - FAILED
      example: SUCCEEDED
    BulkUpsertStatusResponse:
      description: ID of the bulk request.
      type: object
      properties:
        status:
          $ref: '#/components/schemas/BulkUpsertStatus'
        result_url:
          type: string
          example: https://pinterest-waterloo.s3.us-east-1.amazonaws.com/bulk_framework/AD_ENTITY_UPSERT/549763856637-1659122537-0b4d77d3-f620-48ce-bec9-616106afb8d4/(...)
    BusinessAccessError:
      nullable: true
      properties:
        code:
          type: integer
        message:
          type: string
      required:
      - code
      - message
      type: object
    BusinessAccessUserSummary:
      type: object
      description: Metadata of the member/partner that has access to the asset.
      properties:
        email:
          description: Email of the business member/partner.
          example: business0101@business.com
          type: string
          nullable: true
        id:
          description: Unique identifier of the business member/partner.
          example: '383791336903426391'
          type: string
          nullable: true
          minLength: 1
          maxLength: 20
        username:
          description: Username of the business member/partner.
          example: business0101
          nullable: true
          type: string
    BusinessAccessRole:
      type: string
      description: Permission role for business access.
      example: ADMIN
      enum:
      - OWNER
      - ADMIN
      - ANALYST
      - SOS_READER
      - FINANCE_MANAGER
      - AUDIENCE_MANAGER
      - CAMPAIGN_MANAGER
      - CATALOGS_MANAGER
      - RESTRICTED_OWNER
      - PROFILE_MANAGER
      - PROFILE_PUBLISHER
      - RESOURCE_PINNER_LIST_OWNER
      - RESOURCE_PINNER_LIST_READER
      - BIZ_PINNER_LIST_SHARER
      - RESOURCE_CONVERSION_TAGS_READER
    BusinessMemberAssetsSummary:
      type: object
      description: Ad accounts and profiles the business member/partner has access
        to.
      nullable: true
      properties:
        ad_accounts:
          type: array
          description: List of ad account IDs and respective permission levels.
          items:
            type: object
            properties:
              id:
                type: string
                description: Unique identifier of a business ad account.
                example: '549755885175'
                pattern: ^\d+$
                minLength: 1
                maxLength: 20
              permissions:
                $ref: '#/components/schemas/PermissionsResponse'
        profiles:
          type: array
          description: List of profile IDs and respective permission levels.
          items:
            type: object
            properties:
              id:
                type: string
                description: Unique identifier of a business profile.
                example: '383791336903426391'
                pattern: ^\d+$
                minLength: 1
                maxLength: 20
              permissions:
                $ref: '#/components/schemas/PermissionsResponse'
    BusinessRoleCheckMode:
      description: Specifies if the partner is internal or external.
      enum:
      - INTERNAL
      - EXTERNAL
      example: INTERNAL
      type: string
    BusinessRole:
      type: string
      description: |-
        The access level a member/partner has to the business. Values are case-sensitive.
        <br> - EMPLOYEE: Can only view and access assets you assign to them.
        They cannot see details about other employees, partners, or other assets.
        <br> - BIZ_ADMIN: Have full control of roles and can add employees and partners as well as grant asset access.
        <br> - PARTNER: Can only view and access assets you assign them to/or they assign to you.
      example: BIZ_ADMIN
      enum:
      - EMPLOYEE
      - BIZ_ADMIN
      - PARTNER
    BusinessRoleForMembers:
      type: string
      description: |-
        The access level a member has to the business. Values are case-sensitive.
        <br> - EMPLOYEE: Can only view and access assets you assign to them.
        They cannot see details about other employees, partners, or other assets.
        <br> - BIZ_ADMIN: Have full control of roles and can add employees and partners as well as grant asset access.
      example: BIZ_ADMIN
      enum:
      - EMPLOYEE
      - BIZ_ADMIN
    BusinessRoleResponse:
      type: string
      description: |-
        The access level a member/partner has to the business. Values are case-sensitive.
        <br> - EMPLOYEE: Can only view and access assets you assign to them.
        They cannot see details about other employees, partners, or other assets.
        <br> - BIZ_ADMIN: Have full control of roles and can add employees or external partners as well as grant asset access.
        <br> - PARTNER: Can only view and access assets you assign them to/or they assign to you.
      example: BIZ_ADMIN
    UpdatePartnerAssetAccessBody:
      type: object
      required:
      - accesses
      properties:
        accesses:
          type: array
          minItems: 1
          maxItems: 50
          items:
            type: object
            required:
            - partner_id
            - asset_id
            - permissions
            properties:
              partner_id:
                type: string
                description: Unique identifier of a business partner to update asset
                  access to.
                example: '1234567890123'
                maxLength: 25
                pattern: ^\d+$
              asset_id:
                type: string
                description: Unique identifier of the business asset.
                example: '549755885175'
                maxLength: 25
                pattern: ^\d+$
              permissions:
                type: array
                description: A non-empty array of permissions to assign to the partner.
                example:
                - ANALYST
                - ADMIN
                minItems: 1
                maxItems: 50
                items:
                  $ref: '#/components/schemas/Permissions'
    DeletePartnerAssetAccessBody:
      type: object
      required:
      - accesses
      properties:
        accesses:
          type: array
          minItems: 1
          maxItems: 50
          items:
            type: object
            properties:
              partner_id:
                type: string
                description: Unique identifier of a business partner to update asset
                  access to.
                example: '1234567890123'
                maxLength: 25
                pattern: ^\d+$
              asset_id:
                type: string
                description: Unique identifier of the business asset.
                example: '549755885175'
                maxLength: 25
                pattern: ^\d+$
              partner_type:
                enum:
                - INTERNAL
                - EXTERNAL
                example: INTERNAL
                description: |-
                  If partner_type=INTERNAL, the deleted asset access is for the access the partner has to your business asset.<br>
                  If partner_type=EXTERNAL, the deleted asset access is for the access you have to the partner's business asset.
                default: INTERNAL
                type: string
            required:
            - partner_id
            - asset_id
    DeletePartnerAssetsResult:
      type: object
      description: The terminated asset access.
      properties:
        asset_id:
          description: Unique identifier of a business asset.
          example: '549755885175'
          pattern: ^\d+$
          type: string
        asset_type:
          $ref: '#/components/schemas/AssetTypeResponse'
        permissions:
          $ref: '#/components/schemas/PermissionsResponse'
        is_shared_partner:
          type: boolean
          description: If is_shared_partner=FALSE, you terminated a partner's asset
            access to your business asset.<br> If is_shared_partner=TRUE, you terminated
            your asset access to your partner's business asset.
          example: false
        partner_id:
          description: Unique identifier of a business partner.
          example: '140943737684417'
          pattern: ^\d+$
          type: string
    DeletePartnerAssetsResultsResponseArray:
      type: object
      properties:
        items:
          type: array
          description: List of terminated asset access.
          items:
            type: object
            $ref: '#/components/schemas/DeletePartnerAssetsResult'
    UpdateMemberResult:
      type: object
      properties:
        business_role:
          type: string
          description: |-
            The access level a member has to the business. Values are case-sensitive.
            <br> - EMPLOYEE: Can only view and access assets you assign to them.
            They cannot see details about other employees, partners, or other assets.
            <br> - BIZ_ADMIN: Have full control of roles and can add employees and partners as well as grant asset access.
          example: EMPLOYEE
        member_id:
          type: string
          description: Unique identifier of the business member.
          example: '140943737684417'
          pattern: ^\d+$
    UpdateMemberResultsResponseArray:
      type: object
      properties:
        items:
          type: array
          description: List of members with updated business access role.
          items:
            $ref: '#/components/schemas/UpdateMemberResult'
    UpdateMemberBusinessRoleBody:
      description: Single instance of a business member to have its role updated
      properties:
        business_role:
          $ref: '#/components/schemas/BusinessRoleForMembers'
        member_id:
          type: string
          description: Unique identifier of the member
          maxLength: 25
          example: '140943737684417'
          pattern: ^\d+$
      required:
      - member_id
      - business_role
      type: object
    UpdateMemberAssetAccessBody:
      type: object
      description: An object with a list of all the new accesses.
      required:
      - accesses
      properties:
        accesses:
          type: array
          minItems: 1
          maxItems: 50
          items:
            type: object
            required:
            - asset_id
            - member_id
            - permissions
            properties:
              asset_id:
                type: string
                description: Id of the asset to update.
                example: '549755885175'
                maxLength: 25
                pattern: ^\d+$
              member_id:
                type: string
                description: Unique identifier of the member on which to perform the
                  update
                example: '140943737684417'
                maxLength: 25
                pattern: ^\d+$
              permissions:
                type: array
                description: A non-empty array of permissions to assign to the member.
                example:
                - ANALYST
                - ADMIN
                minItems: 1
                maxItems: 50
                items:
                  $ref: '#/components/schemas/Permissions'
    CampaignAudienceMultipliers:
      type: object
      description: |-
        This represents a mapping from Audience ID to a bid price adjustment.

        Multiplier values must be between 0 and 10. A value of 10 represents a 900% increase in bid price (from $1 to $10 for example). A value of 0 will stop distribution for this item on the specified audience in `MAX_BID` ad groups in `CATALOG_SALES` campaigns. All audience multipliers must be set at the same time. If a multiplier is not provided it is assumed to be 1 (no bid adjustment).
      example:
        '123': 1.1
        '456': 1.2
      properties:
        AUDIENCE_ID:
          type: string
          pattern: ^\d+$
      additionalProperties:
        type: number
        format: double
        minimum: 0
        maximum: 10
    CampaignBidOptions:
      type: object
      nullable: true
      description: Object describing the campaign level bid multipliers.
      properties:
        audience_multipliers:
          $ref: '#/components/schemas/CampaignAudienceMultipliers'
        app_type_multipliers:
          $ref: '#/components/schemas/AppTypeMultipliers'
        placement_multipliers:
          $ref: '#/components/schemas/PlacementMultipliers'
    CampaignBidOptionsCreate:
      type: object
      description: Object describing the campaign level bid multipliers.
      allOf:
      - $ref: '#/components/schemas/CampaignBidOptions'
    CampaignBidOptionsUpdate:
      type: object
      description: Object describing an update to the campaign level bid multipliers.
      allOf:
      - $ref: '#/components/schemas/CampaignBidOptions'
      - type: object
        properties:
          update_mask:
            type: array
            items:
              type: string
              enum:
              - AUDIENCE
              - APP_TYPE
              - PLACEMENT
              - GENDER
              - AGE_BUCKET
            description: List of fields to update, only the fields in the list will
              be updated.
        required:
        - update_mask
    CampaignCommon:
      type: object
      description: Campaign Data
      properties:
        ad_account_id:
          description: Campaign's Advertiser ID. If you want to create a campaign
            in a Business Account shared account you need to specify the Business
            Access advertiser ID in both the query path param as well as the request
            body schema.
          example: '549755885175'
          type: string
          pattern: ^\d+$
        name:
          type: string
          description: Campaign name.
          example: ACME Tools
        status:
          type: string
          allOf:
          - $ref: '#/components/schemas/EntityStatus'
        lifetime_spend_cap:
          description: Campaign total spending cap. Required for Campaign Budget Optimization
            (CBO) campaigns. This and "daily_spend_cap" cannot be set at the same
            time.
          example: 1432744744
          type: integer
          nullable: true
        daily_spend_cap:
          description: Campaign daily spending cap. Required for Campaign Budget Optimization
            (CBO) campaigns. This and "lifetime_spend_cap" cannot be set at the same
            time.
          example: 1432744744
          type: integer
          nullable: true
        order_line_id:
          description: Order line ID that appears on the invoice.
          example: '549755885175'
          type: string
          pattern: ^\d+$
          nullable: true
        tracking_urls:
          type: object
          nullable: true
          allOf:
          - $ref: '#/components/schemas/TrackingUrls'
        start_time:
          type: integer
          description: |-
            Timestamp in Unix format for scheduling when ads in the campaign start to appear. Must precede any start times set for child ad groups. Defaults to current time if no time is specified. Learn about <a href="/docs/api-features/managing-campaigns/#campaign-scheduling" target="blank">scheduling campaigns</a>.
            Different start times can be set for the campaign's child ad groups, but they cannot occur before a `start_time` specified for the campaign.
            - If your campaign has a child ad group with a start time specified, and if you update that campaign with a `start_time` that is later than that of the ad group, the campaign `start_time` will supersede the ad group `start_time`, and the request will not return an error.
            - In this scenario, if you call <a href="/docs/api/v5/campaigns-list" target="blank">List campaigns</a> or <a href="/docs/api/v5/ad_groups-list" target="blank">List ad groups</a>, the returned campaigns or ad groups are listed with the start and end times that you assigned them, regardless of supersedence.
          example: 1580865126
          nullable: true
        end_time:
          type: integer
          description: |-
            Timestamp in Unix format for scheduling when ads in the campaign stop appearing. Must occur after any end times for child ad groups. If `end_time` is not specified for the campaign, ads run indefinitely unless you update the campaign, changing their status to `paused`. Learn about <a href="/docs/api-features/managing-campaigns/#campaign-scheduling" target="blank">scheduling campaigns</a>.
            Different end times can be set for the campaign's child ad groups, but they cannot occur after an `end_time` specified for the campaign.
            - If your campaign has a child ad group with an end time specified, and if you update that campaign with an `end_time` that is earlier than that of the ad group, the campaign `end_time` will supersede the ad group `end_time`, and the request will not return an error.
            - In this scenario, if you call <a href="/docs/api/v5/campaigns-list" target="blank">List campaigns</a> or <a href="/docs/api/v5/ad_groups-list" target="blank">List ad groups</a>, the returned campaigns or ad groups are listed with the start and end times that you assigned them, regardless of supersedence.
          example: 1644023526
          nullable: true
        is_flexible_daily_budgets:
          $ref: '#/components/schemas/CampaignIsFlexibleDailyBudgets'
        is_automated_campaign:
          $ref: '#/components/schemas/CampaignIsAutomatedCampaign'
    CampaignCreateCommon:
      type: object
      allOf:
      - $ref: '#/components/schemas/CampaignCommon'
      - type: object
        properties:
          default_ad_group_budget_in_micro_currency:
            type: integer
            description: When transitioning from campaign budget optimization to non-campaign
              budget optimization, the default_ad_group_budget_in_micro_currency will
              propagate to each child ad groups daily budget. Unit is micro currency
              of the associated advertiser account.
            example: 0
            nullable: true
          is_campaign_budget_optimization:
            $ref: '#/components/schemas/CampaignIsCampaignBudgetOptimization'
    CampaignCreateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/CampaignCreateCommon'
      - type: object
        properties:
          is_flexible_daily_budgets:
            type: boolean
            default: false
            nullable: false
            allOf:
            - $ref: '#/components/schemas/CampaignIsFlexibleDailyBudgets'
          is_automated_campaign:
            type: boolean
            default: false
            nullable: false
            allOf:
            - $ref: '#/components/schemas/CampaignIsAutomatedCampaign'
          status:
            type: string
            default: ACTIVE
            allOf:
            - $ref: '#/components/schemas/EntityStatus'
          objective_type:
            $ref: '#/components/schemas/ObjectiveType'
          is_performance_plus:
            description: Enable Pinterest Performance+ for your campaign. To learn
              more, see <a href="https://developers.pinterest.com/docs/api-features/pinterest-performance-plus-setup/">Pinterest
              Performance+ Setup</a>.
            type: boolean
            example: true
            default: false
          bid_options:
            $ref: '#/components/schemas/CampaignBidOptionsCreate'
        required:
        - name
        - objective_type
        - ad_account_id
    CampaignCreateResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/CampaignCreateResponseItem'
    CampaignCreateResponseData:
      type: object
      allOf:
      - $ref: '#/components/schemas/CampaignCreateCommon'
      - $ref: '#/components/schemas/CampaignResponse'
      - type: object
        properties:
          objective_type:
            $ref: '#/components/schemas/ObjectiveType'
    CampaignCreateResponseItem:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/CampaignCreateResponseData'
        exceptions:
          type: array
          items:
            $ref: '#/components/schemas/Exception'
    CampaignId:
      properties:
        id:
          description: Campaign ID.
          example: '549755885175'
          type: string
          pattern: ^\d+$
      type: object
    CampaignIdFilter:
      type: object
      properties:
        campaign_ids:
          type: array
          description: List of campaign ids
          example:
          - '12345678'
          items:
            type: string
            pattern: ^\d+$
          maxItems: 500
          minItems: 1
    CampaignIsAutomatedCampaign:
      type: boolean
      description: Specifies whether the campaign was created in the automated campaign
        flow
      example: true
      nullable: true
    CampaignIsCampaignBudgetOptimization:
      type: boolean
      description: Determines if a campaign automatically generate ad-group level
        budgets given a campaign budget to maximize campaign outcome. When transitioning
        from non-cbo to cbo, all previous child ad group budget will be cleared.
      example: true
      nullable: true
    CampaignIsFlexibleDailyBudgets:
      type: boolean
      description: Determine if a campaign has setup for flexible daily budgets, also
        known as "Pinterest Performance+ budgets".
      example: true
      nullable: true
    CampaignResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/CampaignId'
      - $ref: '#/components/schemas/CampaignCommon'
      - type: object
        properties:
          objective_type:
            $ref: '#/components/schemas/ObjectiveType'
          created_time:
            type: integer
            description: Campaign creation time. Unix timestamp in seconds.
            example: 1432744744
          updated_time:
            type: integer
            description: UTC timestamp. Last update time.
            example: 1432744744
          type:
            type: string
            description: Always "campaign".
            example: campaign
          is_campaign_budget_optimization:
            $ref: '#/components/schemas/CampaignIsCampaignBudgetOptimization'
          summary_status:
            $ref: '#/components/schemas/CampaignSummaryStatus'
          is_performance_plus:
            description: Enable Pinterest Performance+ for your campaign. To learn
              more, see <a href="https://developers.pinterest.com/docs/api-features/pinterest-performance-plus-setup/">Pinterest
              Performance+ Setup</a>.
            type: boolean
            example: true
          bid_options:
            $ref: '#/components/schemas/CampaignBidOptions'
    CampaignSummaryStatus:
      type: string
      description: Summary status for campaign
      example: RUNNING
      enum:
      - RUNNING
      - PAUSED
      - NOT_STARTED
      - COMPLETED
      - ADVERTISER_DISABLED
      - ARCHIVED
      - DRAFT
      - DELETED_DRAFT
    CampaignUpdateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/CampaignId'
      - $ref: '#/components/schemas/CampaignCreateCommon'
      - type: object
        properties:
          objective_type:
            type: string
            nullable: true
            allOf:
            - $ref: '#/components/schemas/ObjectiveType'
          is_performance_plus:
            description: Enable Pinterest Performance+ for your campaign. To learn
              more, see <a href="https://developers.pinterest.com/docs/api-features/pinterest-performance-plus-setup/">Pinterest
              Performance+ Setup</a>. This field is immutable, except only for campaigns
              in draft status which may update this field.
            type: boolean
            example: true
          bid_options:
            $ref: '#/components/schemas/CampaignBidOptionsUpdate'
        required:
        - id
        - ad_account_id
    CampaignUpdateResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/CampaignCreateResponse'
    CampaignsAnalyticsResponse:
      type: array
      items:
        type: object
        properties:
          CAMPAIGN_ID:
            description: The ID of the campaing that this metrics belongs to. Returned
              as long as aggregate_report_rows is not true.
            type: string
            pattern: ^\d+$
          DATE:
            description: Current metrics date. Only returned when granularity is a
              time-based value (`DAY`, `HOUR`, `WEEK`, `MONTH`)
            type: string
            format: date
        additionalProperties: true
        example:
          DATE: '2021-04-01'
          CAMPAIGN_ID: '547602124502'
          SPEND_IN_DOLLAR: 30
          TOTAL_CLICKTHROUGH: 216
    CampaignObjectivesFilter:
      type: object
      properties:
        campaign_objective_types:
          type: array
          description: List of values for filtering. ["WEB_SESSIONS"] in BETA.
          example:
          - AWARENESS
          items:
            $ref: '#/components/schemas/ObjectiveType'
          maxItems: 7
          minItems: 1
    CarouselSlot:
      type: object
      properties:
        title:
          type: string
          description: Carousel Pin slot title.
        description:
          type: string
          description: Carousel Pin slot description.
        link:
          type: string
          description: Carousel Pin slot link.
    CancelInvitesBody:
      description: Request body used to cancel invites
      type: object
      required:
      - invite_ids
      properties:
        invite_ids:
          description: List of invite/request ids to be cancelled
          example:
          - '1234567890123456789'
          - '1122334455667788991'
          items:
            type: string
            maxLength: 25
            pattern: ^\d+$
          type: array
          minItems: 1
          maxItems: 50
    Catalog:
      type: object
      title: catalog
      description: Catalog entity
      allOf:
      - $ref: '#/components/schemas/CatalogsDbItem'
      - type: object
        properties:
          id:
            description: ID of the catalog entity.
            example: '864344156814050986'
            type: string
            pattern: ^\d+$
          name:
            description: A human-friendly name associated to a catalog entity.
            nullable: true
            type: string
          catalog_type:
            $ref: '#/components/schemas/CatalogsType'
        required:
        - id
        - name
        - catalog_type
    CatalogsCreateRequest:
      type: object
      title: catalogs_create_request
      description: Request object for creating a catalog.
      additionalProperties: false
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        name:
          description: A human-friendly name associated to a given catalog.
          type: string
      required:
      - catalog_type
      - name
    CatalogsDbItem:
      type: object
      title: db_item
      properties:
        created_at:
          type: string
          format: date-time
          example: '2022-03-14T15:15:22Z'
        id:
          type: string
        updated_at:
          type: string
          format: date-time
          example: '2022-03-14T15:16:34Z'
      required:
      - id
      - created_at
      - updated_at
    CatalogsCreateReportResponse:
      type: object
      properties:
        token:
          type: string
          description: Token to be used to get the report
    CatalogsReport:
      type: object
      properties:
        report_status:
          type: string
          enum:
          - FINISHED
          - IN_PROGRESS
        url:
          type: string
          nullable: true
          description: URL to download the report
        size:
          type: number
          nullable: true
          description: Size of the report in bytes
    CatalogsReportStats:
      type: object
      description: Diagnostics aggregated numbers
      oneOf:
      - $ref: '#/components/schemas/CatalogsReportFeedIngestionStats'
      - $ref: '#/components/schemas/CatalogsReportDistributionStats'
      discriminator:
        propertyName: report_type
        mapping:
          FEED_INGESTION_ISSUES: '#/components/schemas/CatalogsReportFeedIngestionStats'
          DISTRIBUTION_ISSUES: '#/components/schemas/CatalogsReportDistributionStats'
      properties:
        report_type:
          type: string
          enum:
          - FEED_INGESTION_ISSUES
          - DISTRIBUTION_ISSUES
      required:
      - report_type
    CatalogsReportFeedIngestionStats:
      type: object
      properties:
        report_type:
          type: string
          enum:
          - FEED_INGESTION_ISSUES
        catalog_id:
          type: string
          pattern: ^\d+$
          description: ID of the catalog entity.
        code:
          description: The event code that a diagnostics aggregated number references
          type: integer
          example: 112
        code_label:
          description: A human-friendly label for the event code (e.g, 'AVAILABILITY_INVALID')
          type: string
          example: AVAILABILITY_INVALID
        message:
          description: Title message describing the diagnostic issue
          type: string
        occurrences:
          description: Number of occurrences of the issue
          example: 10
          type: integer
        severity:
          description: An ERROR means that items have been dropped, while a WARN denotes
            that items have been ingested despite an issue
          type: string
          enum:
          - WARN
          - ERROR
    CatalogsReportDistributionStats:
      type: object
      properties:
        report_type:
          type: string
          enum:
          - DISTRIBUTION_ISSUES
        catalog_id:
          type: string
          pattern: ^\d+$
          description: ID of the catalog entity.
        code:
          description: The event code that a diagnostics aggregated number references
          type: integer
        code_label:
          description: A human-friendly label for the event code (e.g, 'SPAM')
          type: string
          example: SPAM
        message:
          description: Title message describing the diagnostic issue
          type: string
        occurrences:
          description: Number of occurrences of the issue
          example: 10
          type: integer
        ineligible_for_ads:
          description: Indicates if issue makes items ineligible for ads distribution
          example: true
          type: boolean
        ineligible_for_organic:
          description: Indicates if issue makes items ineligible for organic distribution
          example: true
          type: boolean
    CatalogsReportParameters:
      type: object
      description: Report parameters
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
      required:
      - catalog_type
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailReportParameters'
      - $ref: '#/components/schemas/CatalogsHotelReportParameters'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailReportParameters'
          HOTEL: '#/components/schemas/CatalogsHotelReportParameters'
    CatalogsHotelReportParameters:
      type: object
      description: Parameters for hotel report
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        report:
          type: object
          oneOf:
          - $ref: '#/components/schemas/CatalogsReportFeedIngestionFilter'
          - $ref: '#/components/schemas/CatalogsReportDistributionIssueFilter'
          - $ref: '#/components/schemas/CatalogsReportAllItemsFilter'
          discriminator:
            propertyName: report_type
            mapping:
              FEED_INGESTION_ISSUES: '#/components/schemas/CatalogsReportFeedIngestionFilter'
              DISTRIBUTION_ISSUES: '#/components/schemas/CatalogsReportDistributionIssueFilter'
              ALL_ITEMS: '#/components/schemas/CatalogsReportAllItemsFilter'
          properties:
            report_type:
              type: string
              enum:
              - FEED_INGESTION_ISSUES
              - DISTRIBUTION_ISSUES
              - ALL_ITEMS
      required:
      - catalog_type
      - report
    CatalogsHotelReportStatsParameters:
      type: object
      description: Parameters for hotel report
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        report:
          type: object
          oneOf:
          - $ref: '#/components/schemas/CatalogsReportFeedIngestionFilter'
          - $ref: '#/components/schemas/CatalogsReportDistributionIssueFilter'
          discriminator:
            propertyName: report_type
            mapping:
              FEED_INGESTION_ISSUES: '#/components/schemas/CatalogsReportFeedIngestionFilter'
              DISTRIBUTION_ISSUES: '#/components/schemas/CatalogsReportDistributionIssueFilter'
          properties:
            report_type:
              type: string
              enum:
              - FEED_INGESTION_ISSUES
              - DISTRIBUTION_ISSUES
      required:
      - catalog_type
      - report
    CatalogsRetailReportParameters:
      type: object
      description: Parameters for retail report
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
        report:
          type: object
          oneOf:
          - $ref: '#/components/schemas/CatalogsReportFeedIngestionFilter'
          - $ref: '#/components/schemas/CatalogsReportDistributionIssueFilter'
          - $ref: '#/components/schemas/CatalogsReportAllItemsFilter'
          discriminator:
            propertyName: report_type
            mapping:
              FEED_INGESTION_ISSUES: '#/components/schemas/CatalogsReportFeedIngestionFilter'
              DISTRIBUTION_ISSUES: '#/components/schemas/CatalogsReportDistributionIssueFilter'
              ALL_ITEMS: '#/components/schemas/CatalogsReportAllItemsFilter'
          properties:
            report_type:
              type: string
              enum:
              - FEED_INGESTION_ISSUES
              - DISTRIBUTION_ISSUES
              - ALL_ITEMS
      required:
      - catalog_type
      - report
    CatalogsRetailReportStatsParameters:
      type: object
      description: Parameters for retail report
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
        report:
          type: object
          oneOf:
          - $ref: '#/components/schemas/CatalogsReportFeedIngestionFilter'
          - $ref: '#/components/schemas/CatalogsReportDistributionIssueFilter'
          discriminator:
            propertyName: report_type
            mapping:
              FEED_INGESTION_ISSUES: '#/components/schemas/CatalogsReportFeedIngestionFilter'
              DISTRIBUTION_ISSUES: '#/components/schemas/CatalogsReportDistributionIssueFilter'
          properties:
            report_type:
              type: string
              enum:
              - FEED_INGESTION_ISSUES
              - DISTRIBUTION_ISSUES
      required:
      - catalog_type
      - report
    CatalogsReportFeedIngestionFilter:
      type: object
      additionalProperties: false
      properties:
        report_type:
          type: string
          enum:
          - FEED_INGESTION_ISSUES
        feed_id:
          type: string
          pattern: ^\d+$
          description: ID of the feed entity.
        processing_result_id:
          type: string
          pattern: ^\d+$
          description: Unique identifier of a feed processing result. It can be acquired
            from the "id" field of the "items" array within the response of the [List
            processing results for a given feed](/docs/api/v5/#operation/feed_processing_results/list).
            If not provided, default to most recent completed processing result.
      required:
      - report_type
      - feed_id
    CatalogsReportDistributionIssueFilter:
      type: object
      additionalProperties: false
      properties:
        report_type:
          type: string
          enum:
          - DISTRIBUTION_ISSUES
        catalog_id:
          type: string
          description: Unique identifier of a catalog. If not given, oldest catalog
            will be used
          pattern: ^\d+$
      required:
      - report_type
    CatalogsReportAllItemsFilter:
      type: object
      additionalProperties: false
      properties:
        report_type:
          type: string
          enum:
          - ALL_ITEMS
        catalog_id:
          type: string
          description: Unique identifier of a catalog. If not given, oldest catalog
            will be used
          pattern: ^\d+$
      required:
      - report_type
    CatalogsHotelBatchItem:
      description: Hotel batch item
      type: object
      anyOf:
      - $ref: '#/components/schemas/CatalogsCreateHotelItem'
      - $ref: '#/components/schemas/CatalogsUpsertHotelItem'
      - $ref: '#/components/schemas/CatalogsUpdateHotelItem'
      - $ref: '#/components/schemas/CatalogsDeleteHotelItem'
      discriminator:
        propertyName: operation
        mapping:
          CREATE: '#/components/schemas/CatalogsCreateHotelItem'
          UPSERT: '#/components/schemas/CatalogsUpsertHotelItem'
          UPDATE: '#/components/schemas/CatalogsUpdateHotelItem'
          DELETE: '#/components/schemas/CatalogsDeleteHotelItem'
    CatalogsFeed:
      type: object
      title: catalogs_feed
      description: Catalogs Feed object
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailFeed'
      - $ref: '#/components/schemas/CatalogsHotelFeed'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsFeed'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailFeed'
          HOTEL: '#/components/schemas/CatalogsHotelFeed'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsFeed'
    CatalogsCreativeAssetsFeed:
      type: object
      title: catalogs_creative_assets_feed
      description: Catalogs Creative Asset Feed object
      allOf:
      - $ref: '#/components/schemas/CatalogsDbItem'
      - type: object
        title: feed_fields
        properties:
          name:
            description: A human-friendly name associated to a given feed. This value
              is currently nullable due to historical reasons. It is expected to become
              non-nullable in the future.
            nullable: true
            type: string
          format:
            $ref: '#/components/schemas/CatalogsFormat'
          catalog_type:
            $ref: '#/components/schemas/CatalogsType'
          credentials:
            $ref: '#/components/schemas/CatalogsFeedCredentials'
          location:
            description: The URL where a feed is available for download. This URL
              is what Pinterest will use to download a feed for processing.
            type: string
          preferred_processing_schedule:
            $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
          status:
            $ref: '#/components/schemas/CatalogsStatus'
          default_currency:
            $ref: '#/components/schemas/NullableCurrency'
          default_locale:
            description: The locale used within a feed for product descriptions.
            example: en-US
            type: string
          default_country:
            $ref: '#/components/schemas/Country'
          catalog_id:
            description: Catalog id pertaining to the feed. If not provided, feed
              will use a default catalog based on type.
            type: string
            pattern: ^\d+$
        required:
        - credentials
        - format
        - location
        - name
        - preferred_processing_schedule
        - status
        - catalog_type
        - default_locale
        - default_currency
        - default_country
        - catalog_id
    CatalogsHotelFeed:
      type: object
      title: catalogs_hotel_feed
      description: Catalogs Hotel Feed object
      allOf:
      - $ref: '#/components/schemas/CatalogsDbItem'
      - type: object
        title: feed_fields
        properties:
          name:
            description: A human-friendly name associated to a given feed. This value
              is currently nullable due to historical reasons. It is expected to become
              non-nullable in the future.
            nullable: true
            type: string
          format:
            $ref: '#/components/schemas/CatalogsFormat'
          catalog_type:
            $ref: '#/components/schemas/CatalogsType'
          credentials:
            $ref: '#/components/schemas/CatalogsFeedCredentials'
          location:
            description: The URL where a feed is available for download. This URL
              is what Pinterest will use to download a feed for processing.
            type: string
          preferred_processing_schedule:
            $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
          status:
            $ref: '#/components/schemas/CatalogsStatus'
          default_currency:
            $ref: '#/components/schemas/NullableCurrency'
          default_locale:
            description: The locale used within a feed for product descriptions.
            example: en-US
            type: string
          catalog_id:
            description: Catalog id pertaining to the feed. If not provided, feed
              will use a default catalog based on type.
            nullable: true
            type: string
            pattern: ^\d+$
        required:
        - credentials
        - format
        - location
        - name
        - preferred_processing_schedule
        - status
        - catalog_type
        - default_locale
        - default_currency
        - catalog_id
    CatalogsRetailFeed:
      type: object
      title: catalogs_retail_feed
      description: Catalogs Retail Feed object
      allOf:
      - $ref: '#/components/schemas/CatalogsDbItem'
      - type: object
        title: feed_fields
        properties:
          name:
            description: A human-friendly name associated to a given feed. This value
              is currently nullable due to historical reasons. It is expected to become
              non-nullable in the future.
            nullable: true
            type: string
          format:
            $ref: '#/components/schemas/CatalogsFormat'
          catalog_type:
            $ref: '#/components/schemas/CatalogsType'
          credentials:
            $ref: '#/components/schemas/CatalogsFeedCredentials'
          location:
            description: The URL where a feed is available for download. This URL
              is what Pinterest will use to download a feed for processing.
            type: string
          preferred_processing_schedule:
            $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
          status:
            $ref: '#/components/schemas/CatalogsStatus'
          default_currency:
            $ref: '#/components/schemas/NullableCurrency'
          default_locale:
            description: The locale used within a feed for product descriptions.
            example: en-US
            type: string
          default_country:
            $ref: '#/components/schemas/Country'
          default_availability:
            $ref: '#/components/schemas/ProductAvailabilityType'
        required:
        - credentials
        - default_availability
        - default_country
        - default_currency
        - default_locale
        - format
        - location
        - name
        - preferred_processing_schedule
        - status
        - catalog_type
    CatalogsFeedCredentials:
      type: object
      nullable: true
      description: This field is **OPTIONAL**. Use this if your feed file requires
        username and password.
      properties:
        password:
          description: The required password for downloading a feed.
          type: string
          format: password
        username:
          description: The required username for downloading a feed.
          type: string
      required:
      - username
      - password
    CatalogsFeedIngestionDetails:
      type: object
      properties:
        errors:
          $ref: '#/components/schemas/CatalogsFeedIngestionErrors'
        info:
          $ref: '#/components/schemas/CatalogsFeedIngestionInfo'
        warnings:
          $ref: '#/components/schemas/CatalogsFeedIngestionWarnings'
      required:
      - errors
      - info
      - warnings
    CatalogsFeedIngestionErrors:
      type: object
      properties:
        LINE_LEVEL_INTERNAL_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to ingest
            this some items. The next ingestion will happen in 24 hours.
        LARGE_PRODUCT_COUNT_DECREASE:
          type: integer
          enum:
          - 1
          description: The product count has decreased by more than 99% compared to
            the last successful ingestion.
        ACCOUNT_FLAGGED:
          type: integer
          description: We detected an issue with your account and are not currently
            ingesting your items. Please review our policies at policy.pinterest.com/community-guidelines#section-spam
            or contact us at help.pinterest.com/contact for more information.
        IMAGE_LEVEL_INTERNAL_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some images. The next download attempt will happen in 24 hours.
        IMAGE_FILE_NOT_ACCESSIBLE:
          type: integer
          description: Image files are unreadable. Please upload new files to continue.
        IMAGE_MALFORMED_URL:
          type: integer
          description: Image files are unreadable. Please check your link and upload
            new files to continue.
        IMAGE_FILE_NOT_FOUND:
          type: integer
          description: Image files are unreadable. Please upload new files to continue.
        IMAGE_INVALID_FILE:
          type: integer
          description: Image files are unreadable. Please upload new files to continue.
        FETCH_GOOGLE_SHEET_NOT_SHARED:
          type: integer
          description: Update your Google Sheets sharing settings to 'Anyone with
            link' as a Viewer so that Pinterest can access your file.
    CatalogsFeedIngestionInfo:
      type: object
      properties:
        IN_STOCK:
          type: integer
          description: The number of ingested products that are in stock.
        OUT_OF_STOCK:
          type: integer
          description: The number of ingested products that are in out of stock.
        PREORDER:
          type: integer
          description: The number of ingested products that are in preorder.
    CatalogsFeedIngestion:
      type: object
      properties:
        id:
          type: string
          example: '01234'
        feed_id:
          type: string
          example: '56789'
        created_at:
          type: string
          format: date-time
          example: '2022-03-14T15:16:34Z'
        status:
          $ref: '#/components/schemas/CatalogsFeedProcessingStatus'
      required:
      - id
      - feed_id
      - created_at
      - status
    CatalogsFeedIngestionWarnings:
      type: object
      properties:
        FETCH_GOOGLE_SHEET_PUBLIC_CAN_EDIT:
          type: integer
          description: Update your Google Sheets sharing settings from 'Editor' to
            'Viewer'.
        HOTEL_PRICE_HEADER_IS_PRESENT:
          type: integer
          description: Price is not a supported column. Use base_price and sale_price
            instead.
        ADDITIONAL_IMAGE_LEVEL_INTERNAL_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        ADDITIONAL_IMAGE_FILE_NOT_ACCESSIBLE:
          type: integer
          description: Additional image files are unreadable. Please upload new files
            to continue.
        ADDITIONAL_IMAGE_MALFORMED_URL:
          type: integer
          description: Additional image files are unreadable. Please check your link
            and upload new files to continue.
        ADDITIONAL_IMAGE_FILE_NOT_FOUND:
          type: integer
          description: Additional image files are unreadable. Please upload new files
            to continue.
        ADDITIONAL_IMAGE_INVALID_FILE:
          type: integer
          description: Additional image files are unreadable. Please upload new files
            to continue.
        VIDEO_LEVEL_INTERNAL_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional videos. The next download attempt will happen in 24 hours.
        VIDEO_FILE_NOT_ACCESSIBLE:
          type: integer
          description: Video files are unreadable. Please upload new files to continue.
        VIDEO_MALFORMED_URL:
          type: integer
          description: Video files are unreadable. Please check your link and upload
            new files to continue.
        VIDEO_FILE_NOT_FOUND:
          type: integer
          description: Video files are unreadable. Please upload new files to continue.
        VIDEO_INVALID_FILE:
          type: integer
          description: Video files are unreadable. Please upload new files to continue.
        VIDEO_DOWNLOAD_VIDEO_TOO_SHORT:
          type: integer
          description: Video length is too short. Please ensure that the main video
            is at least 4 seconds long.
        AD_IMAGE_DOWNLOAD_INTERNAL_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_IMAGE_DOWNLOAD_INTERNAL_REQUEST_EXPIRED:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_IMAGE_DOWNLOAD_INTERNAL_MALFORMED_URL:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_INTERNAL_CONFIGURATION_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_IMAGE_DOWNLOAD_INTERNAL_RATE_LIMITED:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_IMAGE_DOWNLOAD_INTERNAL_FAILED_TO_DOWNLOAD:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_400:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_403:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_404:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_405:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_410:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_429:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_500:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_502:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_503:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_504:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_507:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_508:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_520:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_521:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_522:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_HTTP_STATUS_525:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_SITE_TIMEOUT:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_CONTENT_READ_ERROR:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_SITE_ERROR:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_SSL_ERROR:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_SSL_HANDSHAKE_ERROR:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_DNS_LOOKUP_ERROR:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_FILE_NOT_FOUND:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_FILE_NOT_ACCESSIBLE:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_DOWNLOAD_INVALID_FILE:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_IMAGE_PROCESSING_HEIGHT_TOO_SMALL:
          type: integer
          description: Ad images must have a height larger than 75 pixels
        AD_IMAGE_PROCESSING_WIDTH_TOO_SMALL:
          type: integer
          description: Ad images must have a width larger than 75 pixels
        AD_IMAGE_PROCESSING_TOO_MANY_PIXELS:
          type: integer
          description: Ad images must have a maximum area (width x height) of less
            than 89478485 pixels
        AD_IMAGE_PROCESSING_TYPE_MISMATCH:
          type: integer
          description: Some ad images could not be processed due to a file type mismatch.
        AD_IMAGE_PROCESSING_EMPTY_FILE:
          type: integer
          description: Ad image files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_INTERNAL_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_VIDEO_DOWNLOAD_INTERNAL_REQUEST_EXPIRED:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_VIDEO_DOWNLOAD_INTERNAL_MALFORMED_URL:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_INTERNAL_CONFIGURATION_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_VIDEO_DOWNLOAD_INTERNAL_RATE_LIMITED:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_VIDEO_DOWNLOAD_INTERNAL_FAILED_TO_DOWNLOAD:
          type: integer
          description: We experienced a technical difficulty and were unable to download
            some additional images. The next download attempt will happen in 24 hours.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_400:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_403:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_404:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_405:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_410:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_429:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_500:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_502:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_503:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_504:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_507:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_508:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_520:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_521:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_522:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_HTTP_STATUS_525:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_SITE_TIMEOUT:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_CONTENT_READ_ERROR:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_SITE_ERROR:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_SSL_ERROR:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_SSL_HANDSHAKE_ERROR:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_DNS_LOOKUP_ERROR:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_FILE_NOT_FOUND:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_FILE_NOT_ACCESSIBLE:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_DOWNLOAD_INVALID_FILE:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_PROCESSING_HEIGHT_TOO_SMALL:
          type: integer
          description: Ad videos must have a height larger than 75 pixels
        AD_VIDEO_PROCESSING_WIDTH_TOO_SMALL:
          type: integer
          description: Ad videos must have a width larger than 75 pixels
        AD_VIDEO_PROCESSING_TOO_MANY_PIXELS:
          type: integer
          description: Ad videos must have a maximum area (width x height) of less
            than 89478485 pixels
        AD_VIDEO_PROCESSING_TYPE_MISMATCH:
          type: integer
          description: Some ad videos could not be processed due to a file type mismatch.
        AD_VIDEO_PROCESSING_EMPTY_FILE:
          type: integer
          description: Ad video files are unreadable. Please check your link and upload
            new files to continue.
        AD_VIDEO_LENGTH_TOO_SHORT:
          type: integer
          description: Ad videos length is too short. Please ensure that all ad videos
            are at least 4 seconds long.
    CatalogsFeedProcessingResult:
      type: object
      allOf:
      - $ref: '#/components/schemas/CatalogsDbItem'
      - type: object
        title: catalogs_feed_processing_result_fields
        properties:
          ingestion_details:
            $ref: '#/components/schemas/CatalogsFeedIngestionDetails'
          status:
            $ref: '#/components/schemas/CatalogsFeedProcessingStatus'
          product_counts:
            $ref: '#/components/schemas/CatalogsFeedProductCounts'
          validation_details:
            $ref: '#/components/schemas/CatalogsFeedValidationDetails'
        required:
        - ingestion_details
        - status
        - product_counts
        - validation_details
    CatalogsFeedProcessingSchedule:
      type: object
      title: catalogs_processing_schedule
      description: Daily processing schedule. This field is **OPTIONAL**. Use this
        to configure the preferred time for processing a feed (otherwise random).
      nullable: true
      properties:
        time:
          description: A time in format HH:MM with leading 0 (zero)
          type: string
          pattern: ^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$
          example: 02:59
        timezone:
          description: The timezone considered for the processing schedule time.
          type: string
          nullable: true
          enum:
          - Africa/Abidjan
          - Africa/Accra
          - Africa/Algiers
          - Africa/Bissau
          - Africa/Cairo
          - Africa/Casablanca
          - Africa/Ceuta
          - Africa/El_Aaiun
          - Africa/Johannesburg
          - Africa/Juba
          - Africa/Khartoum
          - Africa/Lagos
          - Africa/Maputo
          - Africa/Monrovia
          - Africa/Nairobi
          - Africa/Ndjamena
          - Africa/Sao_Tome
          - Africa/Tripoli
          - Africa/Tunis
          - Africa/Windhoek
          - America/Adak
          - America/Anchorage
          - America/Araguaina
          - America/Argentina/Buenos_Aires
          - America/Argentina/Catamarca
          - America/Argentina/Cordoba
          - America/Argentina/Jujuy
          - America/Argentina/La_Rioja
          - America/Argentina/Mendoza
          - America/Argentina/Rio_Gallegos
          - America/Argentina/Salta
          - America/Argentina/San_Juan
          - America/Argentina/San_Luis
          - America/Argentina/Tucuman
          - America/Argentina/Ushuaia
          - America/Asuncion
          - America/Atikokan
          - America/Bahia
          - America/Bahia_Banderas
          - America/Barbados
          - America/Belem
          - America/Belize
          - America/Blanc-Sablon
          - America/Boa_Vista
          - America/Bogota
          - America/Boise
          - America/Cambridge_Bay
          - America/Campo_Grande
          - America/Cancun
          - America/Caracas
          - America/Cayenne
          - America/Chicago
          - America/Chihuahua
          - America/Costa_Rica
          - America/Creston
          - America/Cuiaba
          - America/Curacao
          - America/Danmarkshavn
          - America/Dawson
          - America/Dawson_Creek
          - America/Denver
          - America/Detroit
          - America/Edmonton
          - America/Eirunepe
          - America/El_Salvador
          - America/Fort_Nelson
          - America/Fortaleza
          - America/Glace_Bay
          - America/Goose_Bay
          - America/Grand_Turk
          - America/Guatemala
          - America/Guayaquil
          - America/Guyana
          - America/Halifax
          - America/Havana
          - America/Hermosillo
          - America/Indiana/Indianapolis
          - America/Indiana/Knox
          - America/Indiana/Marengo
          - America/Indiana/Petersburg
          - America/Indiana/Tell_City
          - America/Indiana/Vevay
          - America/Indiana/Vincennes
          - America/Indiana/Winamac
          - America/Inuvik
          - America/Iqaluit
          - America/Jamaica
          - America/Juneau
          - America/Kentucky/Louisville
          - America/Kentucky/Monticello
          - America/La_Paz
          - America/Lima
          - America/Los_Angeles
          - America/Maceio
          - America/Managua
          - America/Manaus
          - America/Martinique
          - America/Matamoros
          - America/Mazatlan
          - America/Menominee
          - America/Merida
          - America/Metlakatla
          - America/Mexico_City
          - America/Miquelon
          - America/Moncton
          - America/Monterrey
          - America/Montevideo
          - America/Nassau
          - America/New_York
          - America/Nipigon
          - America/Nome
          - America/Noronha
          - America/North_Dakota/Beulah
          - America/North_Dakota/Center
          - America/North_Dakota/New_Salem
          - America/Nuuk
          - America/Ojinaga
          - America/Panama
          - America/Pangnirtung
          - America/Paramaribo
          - America/Phoenix
          - America/Port-au-Prince
          - America/Port_of_Spain
          - America/Porto_Velho
          - America/Puerto_Rico
          - America/Punta_Arenas
          - America/Rainy_River
          - America/Rankin_Inlet
          - America/Recife
          - America/Regina
          - America/Resolute
          - America/Rio_Branco
          - America/Santarem
          - America/Santiago
          - America/Santo_Domingo
          - America/Sao_Paulo
          - America/Scoresbysund
          - America/Sitka
          - America/St_Johns
          - America/Swift_Current
          - America/Tegucigalpa
          - America/Thule
          - America/Thunder_Bay
          - America/Tijuana
          - America/Toronto
          - America/Vancouver
          - America/Whitehorse
          - America/Winnipeg
          - America/Yakutat
          - America/Yellowknife
          - Antarctica/Casey
          - Antarctica/Davis
          - Antarctica/DumontDUrville
          - Antarctica/Macquarie
          - Antarctica/Mawson
          - Antarctica/Palmer
          - Antarctica/Rothera
          - Antarctica/Syowa
          - Antarctica/Troll
          - Antarctica/Vostok
          - Asia/Almaty
          - Asia/Amman
          - Asia/Anadyr
          - Asia/Aqtau
          - Asia/Aqtobe
          - Asia/Ashgabat
          - Asia/Atyrau
          - Asia/Baghdad
          - Asia/Baku
          - Asia/Bangkok
          - Asia/Barnaul
          - Asia/Beirut
          - Asia/Bishkek
          - Asia/Brunei
          - Asia/Chita
          - Asia/Choibalsan
          - Asia/Colombo
          - Asia/Damascus
          - Asia/Dhaka
          - Asia/Dili
          - Asia/Dubai
          - Asia/Dushanbe
          - Asia/Famagusta
          - Asia/Gaza
          - Asia/Hebron
          - Asia/Ho_Chi_Minh
          - Asia/Hong_Kong
          - Asia/Hovd
          - Asia/Irkutsk
          - Asia/Jakarta
          - Asia/Jayapura
          - Asia/Jerusalem
          - Asia/Kabul
          - Asia/Kamchatka
          - Asia/Karachi
          - Asia/Kathmandu
          - Asia/Khandyga
          - Asia/Kolkata
          - Asia/Krasnoyarsk
          - Asia/Kuala_Lumpur
          - Asia/Kuching
          - Asia/Macau
          - Asia/Magadan
          - Asia/Makassar
          - Asia/Manila
          - Asia/Nicosia
          - Asia/Novokuznetsk
          - Asia/Novosibirsk
          - Asia/Omsk
          - Asia/Oral
          - Asia/Pontianak
          - Asia/Pyongyang
          - Asia/Qatar
          - Asia/Qostanay
          - Asia/Qyzylorda
          - Asia/Riyadh
          - Asia/Sakhalin
          - Asia/Samarkand
          - Asia/Seoul
          - Asia/Shanghai
          - Asia/Singapore
          - Asia/Srednekolymsk
          - Asia/Taipei
          - Asia/Tashkent
          - Asia/Tbilisi
          - Asia/Tehran
          - Asia/Thimphu
          - Asia/Tokyo
          - Asia/Tomsk
          - Asia/Ulaanbaatar
          - Asia/Urumqi
          - Asia/Ust-Nera
          - Asia/Vladivostok
          - Asia/Yakutsk
          - Asia/Yangon
          - Asia/Yekaterinburg
          - Asia/Yerevan
          - Atlantic/Azores
          - Atlantic/Bermuda
          - Atlantic/Canary
          - Atlantic/Cape_Verde
          - Atlantic/Faroe
          - Atlantic/Madeira
          - Atlantic/Reykjavik
          - Atlantic/South_Georgia
          - Atlantic/Stanley
          - Australia/Adelaide
          - Australia/Brisbane
          - Australia/Broken_Hill
          - Australia/Currie
          - Australia/Darwin
          - Australia/Eucla
          - Australia/Hobart
          - Australia/Lindeman
          - Australia/Lord_Howe
          - Australia/Melbourne
          - Australia/Perth
          - Australia/Sydney
          - CET
          - CST6CDT
          - EET
          - EST
          - EST5EDT
          - Etc/GMT
          - Etc/GMT+1
          - Etc/GMT+10
          - Etc/GMT+11
          - Etc/GMT+12
          - Etc/GMT+2
          - Etc/GMT+3
          - Etc/GMT+4
          - Etc/GMT+5
          - Etc/GMT+6
          - Etc/GMT+7
          - Etc/GMT+8
          - Etc/GMT+9
          - Etc/GMT-1
          - Etc/GMT-10
          - Etc/GMT-11
          - Etc/GMT-12
          - Etc/GMT-13
          - Etc/GMT-14
          - Etc/GMT-2
          - Etc/GMT-3
          - Etc/GMT-4
          - Etc/GMT-5
          - Etc/GMT-6
          - Etc/GMT-7
          - Etc/GMT-8
          - Etc/GMT-9
          - Etc/UTC
          - Europe/Amsterdam
          - Europe/Andorra
          - Europe/Astrakhan
          - Europe/Athens
          - Europe/Belgrade
          - Europe/Berlin
          - Europe/Brussels
          - Europe/Bucharest
          - Europe/Budapest
          - Europe/Chisinau
          - Europe/Copenhagen
          - Europe/Dublin
          - Europe/Gibraltar
          - Europe/Helsinki
          - Europe/Istanbul
          - Europe/Kaliningrad
          - Europe/Kiev
          - Europe/Kirov
          - Europe/Lisbon
          - Europe/London
          - Europe/Luxembourg
          - Europe/Madrid
          - Europe/Malta
          - Europe/Minsk
          - Europe/Monaco
          - Europe/Moscow
          - Europe/Oslo
          - Europe/Paris
          - Europe/Prague
          - Europe/Riga
          - Europe/Rome
          - Europe/Samara
          - Europe/Saratov
          - Europe/Simferopol
          - Europe/Sofia
          - Europe/Stockholm
          - Europe/Tallinn
          - Europe/Tirane
          - Europe/Ulyanovsk
          - Europe/Uzhgorod
          - Europe/Vienna
          - Europe/Vilnius
          - Europe/Volgograd
          - Europe/Warsaw
          - Europe/Zaporozhye
          - Europe/Zurich
          - HST
          - Indian/Chagos
          - Indian/Christmas
          - Indian/Cocos
          - Indian/Kerguelen
          - Indian/Mahe
          - Indian/Maldives
          - Indian/Mauritius
          - Indian/Reunion
          - MET
          - MST
          - MST7MDT
          - PST8PDT
          - Pacific/Apia
          - Pacific/Auckland
          - Pacific/Bougainville
          - Pacific/Chatham
          - Pacific/Chuuk
          - Pacific/Easter
          - Pacific/Efate
          - Pacific/Enderbury
          - Pacific/Fakaofo
          - Pacific/Fiji
          - Pacific/Funafuti
          - Pacific/Galapagos
          - Pacific/Gambier
          - Pacific/Guadalcanal
          - Pacific/Guam
          - Pacific/Honolulu
          - Pacific/Kiritimati
          - Pacific/Kosrae
          - Pacific/Kwajalein
          - Pacific/Majuro
          - Pacific/Marquesas
          - Pacific/Nauru
          - Pacific/Niue
          - Pacific/Norfolk
          - Pacific/Noumea
          - Pacific/Pago_Pago
          - Pacific/Palau
          - Pacific/Pitcairn
          - Pacific/Pohnpei
          - Pacific/Port_Moresby
          - Pacific/Rarotonga
          - Pacific/Tahiti
          - Pacific/Tarawa
          - Pacific/Tongatapu
          - Pacific/Wake
          - Pacific/Wallis
          - WET
          - null
      required:
      - time
      - timezone
    CatalogsFeedProcessingStatus:
      type: string
      enum:
      - COMPLETED
      - FAILED
      - PROCESSING
    CatalogsFeedProductCounts:
      type: object
      description: The counts can be null early in the process.
      nullable: true
      properties:
        original:
          description: The number of products in the feed file.
          type: integer
        ingested:
          description: The number of products successfully ingested from the feed
            file.
          type: integer
    CatalogsFeedValidationDetails:
      type: object
      properties:
        errors:
          $ref: '#/components/schemas/CatalogsFeedValidationErrors'
        warnings:
          $ref: '#/components/schemas/CatalogsFeedValidationWarnings'
      required:
      - errors
      - warnings
    CatalogsFeedValidationErrors:
      type: object
      properties:
        FETCH_ERROR:
          type: integer
          description: Pinterest couldn't download your feed.
        FETCH_INACTIVE_FEED_ERROR:
          type: integer
          description: "Your feed wasn't ingested because it hasn\u2019t changed in\
            \ the previous 90 days."
        ENCODING_ERROR:
          type: integer
          description: Your feed includes data with an unsupported encoding format.
        DELIMITER_ERROR:
          type: integer
          description: Your feed includes data with formatting errors.
        REQUIRED_COLUMNS_MISSING:
          type: integer
          description: Your feed is missing some required column headers.
        DUPLICATE_PRODUCTS:
          type: integer
          description: Some products are duplicated.
        IMAGE_LINK_INVALID:
          type: integer
          description: Some image links are formatted incorrectly.
        ITEMID_MISSING:
          type: integer
          description: Some items are missing an item id in their product metadata,
            those items will not be published.
        TITLE_MISSING:
          type: integer
          description: Some items are missing a title in their product metadata, those
            items will not be published.
        DESCRIPTION_MISSING:
          type: integer
          description: Some items are missing a description in their product metadata,
            those items will not be published.
        PRODUCT_LINK_MISSING:
          type: integer
          description: Some items are missing a link URL in their product metadata,
            those items will not be published.
        IMAGE_LINK_MISSING:
          type: integer
          description: Some items are missing an image link URL in their product metadata,
            those items will not be published.
        AVAILABILITY_INVALID:
          type: integer
          description: Some items are missing an availability value in their product
            metadata, those items will not be published.
        PRODUCT_PRICE_INVALID:
          type: integer
          description: Some items have price formatting errors in their product metadata,
            those items will not be published.
        LINK_FORMAT_INVALID:
          type: integer
          description: Some link values are formatted incorrectly.
        PARSE_LINE_ERROR:
          type: integer
          description: Your feed contains formatting errors for some items.
        ADWORDS_FORMAT_INVALID:
          type: integer
          description: Some adwords links contain too many characters.
        INTERNAL_SERVICE_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to ingest
            your feed. The next ingestion will happen in 24 hours.
        NO_VERIFIED_DOMAIN:
          type: integer
          description: Your merchant domain needs to be claimed.
        ADULT_INVALID:
          type: integer
          description: Some items have invalid adult values.
        IMAGE_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Some items have image_link URLs that contain too many characters,
            so those items will not be published.
        INVALID_DOMAIN:
          type: integer
          description: Some of your product link values don't match the verified domain
            associated with this account.
        FEED_LENGTH_TOO_LONG:
          type: integer
          description: Your feed contains too many items, some items will not be published.
        LINK_LENGTH_TOO_LONG:
          type: integer
          description: Some product links contain too many characters, those items
            will not be published.
        MALFORMED_XML:
          type: integer
          description: Your feed couldn't be validated because the xml file is formatted
            incorrectly.
        PRICE_MISSING:
          type: integer
          description: Some products are missing a price, those items will not be
            published.
        FEED_TOO_SMALL:
          type: integer
          description: Your feed couldn't be validated because the file doesn't contain
            the minimum number of lines required.
        MAX_ITEMS_PER_ITEM_GROUP_EXCEEDED:
          type: integer
          description: Some items exceed the maximum number of items per item group,
            those items will not be published.
        ITEM_MAIN_IMAGE_DOWNLOAD_FAILURE:
          type: integer
          description: Some items' main images can't be found.
        PINJOIN_CONTENT_UNSAFE:
          type: integer
          description: Some items were not published because they don't meet Pinterest's
            Merchant Guidelines.
        BLOCKLISTED_IMAGE_SIGNATURE:
          type: integer
          description: Some items were not published because they don't meet Pinterest's
            Merchant Guidelines.
        LIST_PRICE_INVALID:
          type: integer
          description: Some items have list price formatting errors in their product
            metadata, those items will not be published.
        PRICE_CANNOT_BE_DETERMINED:
          type: integer
          description: Some items were not published because price cannot be determined.
            The price, list price, and sale price are all different, so those items
            will not be published.
    CatalogsFeedValidationWarnings:
      type: object
      properties:
        AD_IMAGE_0_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 0 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_1_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 1 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_2_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 2 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_3_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 3 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_4_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 4 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_5_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 5 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_6_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 6 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_7_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 7 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_8_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 8 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_9_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 9 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_10_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 10 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_11_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 11 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_12_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 12 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_13_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 13 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_14_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 14 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_15_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 15 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_16_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 16 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_17_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 17 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_18_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 18 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_19_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Ad image link 19 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_0_LINK_WARNING:
          type: integer
          description: Ad image link 0 format is unsupported.
        AD_IMAGE_1_LINK_WARNING:
          type: integer
          description: Ad image link 1 format is unsupported.
        AD_IMAGE_2_LINK_WARNING:
          type: integer
          description: Ad image link 2 format is unsupported.
        AD_IMAGE_3_LINK_WARNING:
          type: integer
          description: Ad image link 3 format is unsupported.
        AD_IMAGE_4_LINK_WARNING:
          type: integer
          description: Ad image link 4 format is unsupported.
        AD_IMAGE_5_LINK_WARNING:
          type: integer
          description: Ad image link 5 format is unsupported.
        AD_IMAGE_6_LINK_WARNING:
          type: integer
          description: Ad image link 6 format is unsupported.
        AD_IMAGE_7_LINK_WARNING:
          type: integer
          description: Ad image link 7 format is unsupported.
        AD_IMAGE_8_LINK_WARNING:
          type: integer
          description: Ad image link 8 format is unsupported.
        AD_IMAGE_9_LINK_WARNING:
          type: integer
          description: Ad image link 9 format is unsupported.
        AD_IMAGE_10_LINK_WARNING:
          type: integer
          description: Ad image link 10 format is unsupported.
        AD_IMAGE_11_LINK_WARNING:
          type: integer
          description: Ad image link 11 format is unsupported.
        AD_IMAGE_12_LINK_WARNING:
          type: integer
          description: Ad image link 12 format is unsupported.
        AD_IMAGE_13_LINK_WARNING:
          type: integer
          description: Ad image link 13 format is unsupported.
        AD_IMAGE_14_LINK_WARNING:
          type: integer
          description: Ad image link 14 format is unsupported.
        AD_IMAGE_15_LINK_WARNING:
          type: integer
          description: Ad image link 15 format is unsupported.
        AD_IMAGE_16_LINK_WARNING:
          type: integer
          description: Ad image link 16 format is unsupported.
        AD_IMAGE_17_LINK_WARNING:
          type: integer
          description: Ad image link 17 format is unsupported.
        AD_IMAGE_18_LINK_WARNING:
          type: integer
          description: Ad image link 18 format is unsupported.
        AD_IMAGE_19_LINK_WARNING:
          type: integer
          description: Ad image link 19 format is unsupported.
        AD_IMAGE_0_LINK_REQUIRED:
          type: integer
          description: Ad image link 0 is required because an image tag was provided.
        AD_IMAGE_1_LINK_REQUIRED:
          type: integer
          description: Ad image link 1 is required because an image tag was provided.
        AD_IMAGE_2_LINK_REQUIRED:
          type: integer
          description: Ad image link 2 is required because an image tag was provided.
        AD_IMAGE_3_LINK_REQUIRED:
          type: integer
          description: Ad image link 3 is required because an image tag was provided.
        AD_IMAGE_4_LINK_REQUIRED:
          type: integer
          description: Ad image link 4 is required because an image tag was provided.
        AD_IMAGE_5_LINK_REQUIRED:
          type: integer
          description: Ad image link 5 is required because an image tag was provided.
        AD_IMAGE_6_LINK_REQUIRED:
          type: integer
          description: Ad image link 6 is required because an image tag was provided.
        AD_IMAGE_7_LINK_REQUIRED:
          type: integer
          description: Ad image link 7 is required because an image tag was provided.
        AD_IMAGE_8_LINK_REQUIRED:
          type: integer
          description: Ad image link 8 is required because an image tag was provided.
        AD_IMAGE_9_LINK_REQUIRED:
          type: integer
          description: Ad image link 9 is required because an image tag was provided.
        AD_IMAGE_10_LINK_REQUIRED:
          type: integer
          description: Ad image link 10 is required because an image tag was provided.
        AD_IMAGE_11_LINK_REQUIRED:
          type: integer
          description: Ad image link 11 is required because an image tag was provided.
        AD_IMAGE_12_LINK_REQUIRED:
          type: integer
          description: Ad image link 12 is required because an image tag was provided.
        AD_IMAGE_13_LINK_REQUIRED:
          type: integer
          description: Ad image link 13 is required because an image tag was provided.
        AD_IMAGE_14_LINK_REQUIRED:
          type: integer
          description: Ad image link 14 is required because an image tag was provided.
        AD_IMAGE_15_LINK_REQUIRED:
          type: integer
          description: Ad image link 15 is required because an image tag was provided.
        AD_IMAGE_16_LINK_REQUIRED:
          type: integer
          description: Ad image link 16 is required because an image tag was provided.
        AD_IMAGE_17_LINK_REQUIRED:
          type: integer
          description: Ad image link 17 is required because an image tag was provided.
        AD_IMAGE_18_LINK_REQUIRED:
          type: integer
          description: Ad image link 18 is required because an image tag was provided.
        AD_IMAGE_19_LINK_REQUIRED:
          type: integer
          description: Ad image link 19 is required because an image tag was provided.
        AD_IMAGE_0_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 0 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_1_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 1 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_2_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 2 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_3_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 3 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_4_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 4 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_5_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 5 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_6_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 6 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_7_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 7 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_8_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 8 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_9_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 9 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_10_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 10 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_11_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 11 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_12_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 12 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_13_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 13 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_14_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 14 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_15_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 15 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_16_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 16 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_17_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 17 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_18_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 18 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_19_TAG_LENGTH_TOO_LONG:
          type: integer
          description: Ad image tag 19 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_0_TAG_REQUIRED:
          type: integer
          description: Ad image tag 0 is required because an image link was provided.
        AD_IMAGE_1_TAG_REQUIRED:
          type: integer
          description: Ad image tag 1 is required because an image link was provided.
        AD_IMAGE_2_TAG_REQUIRED:
          type: integer
          description: Ad image tag 2 is required because an image link was provided.
        AD_IMAGE_3_TAG_REQUIRED:
          type: integer
          description: Ad image tag 3 is required because an image link was provided.
        AD_IMAGE_4_TAG_REQUIRED:
          type: integer
          description: Ad image tag 4 is required because an image link was provided.
        AD_IMAGE_5_TAG_REQUIRED:
          type: integer
          description: Ad image tag 5 is required because an image link was provided.
        AD_IMAGE_6_TAG_REQUIRED:
          type: integer
          description: Ad image tag 6 is required because an image link was provided.
        AD_IMAGE_7_TAG_REQUIRED:
          type: integer
          description: Ad image tag 7 is required because an image link was provided.
        AD_IMAGE_8_TAG_REQUIRED:
          type: integer
          description: Ad image tag 8 is required because an image link was provided.
        AD_IMAGE_9_TAG_REQUIRED:
          type: integer
          description: Ad image tag 9 is required because an image link was provided.
        AD_IMAGE_10_TAG_REQUIRED:
          type: integer
          description: Ad image tag 10 is required because an image link was provided.
        AD_IMAGE_11_TAG_REQUIRED:
          type: integer
          description: Ad image tag 11 is required because an image link was provided.
        AD_IMAGE_12_TAG_REQUIRED:
          type: integer
          description: Ad image tag 12 is required because an image link was provided.
        AD_IMAGE_13_TAG_REQUIRED:
          type: integer
          description: Ad image tag 13 is required because an image link was provided.
        AD_IMAGE_14_TAG_REQUIRED:
          type: integer
          description: Ad image tag 14 is required because an image link was provided.
        AD_IMAGE_15_TAG_REQUIRED:
          type: integer
          description: Ad image tag 15 is required because an image link was provided.
        AD_IMAGE_16_TAG_REQUIRED:
          type: integer
          description: Ad image tag 16 is required because an image link was provided.
        AD_IMAGE_17_TAG_REQUIRED:
          type: integer
          description: Ad image tag 17 is required because an image link was provided.
        AD_IMAGE_18_TAG_REQUIRED:
          type: integer
          description: Ad image tag 18 is required because an image link was provided.
        AD_IMAGE_19_TAG_REQUIRED:
          type: integer
          description: Ad image tag 19 is required because an image link was provided.
        AD_IMAGE_0_LINK_DUPLICATED:
          type: integer
          description: ad_image_0_link is duplicated with another ad image link.
        AD_IMAGE_1_LINK_DUPLICATED:
          type: integer
          description: ad_image_1_link is duplicated with another ad image link.
        AD_IMAGE_2_LINK_DUPLICATED:
          type: integer
          description: ad_image_2_link is duplicated with another ad image link.
        AD_IMAGE_3_LINK_DUPLICATED:
          type: integer
          description: ad_image_3_link is duplicated with another ad image link.
        AD_IMAGE_4_LINK_DUPLICATED:
          type: integer
          description: ad_image_4_link is duplicated with another ad image link.
        AD_IMAGE_5_LINK_DUPLICATED:
          type: integer
          description: ad_image_5_link is duplicated with another ad image link.
        AD_IMAGE_6_LINK_DUPLICATED:
          type: integer
          description: ad_image_6_link is duplicated with another ad image link.
        AD_IMAGE_7_LINK_DUPLICATED:
          type: integer
          description: ad_image_7_link is duplicated with another ad image link.
        AD_IMAGE_8_LINK_DUPLICATED:
          type: integer
          description: ad_image_8_link is duplicated with another ad image link.
        AD_IMAGE_9_LINK_DUPLICATED:
          type: integer
          description: ad_image_9_link is duplicated with another ad image link.
        AD_IMAGE_10_LINK_DUPLICATED:
          type: integer
          description: ad_image_10_link is duplicated with another ad image link.
        AD_IMAGE_11_LINK_DUPLICATED:
          type: integer
          description: ad_image_11_link is duplicated with another ad image link.
        AD_IMAGE_12_LINK_DUPLICATED:
          type: integer
          description: ad_image_12_link is duplicated with another ad image link.
        AD_IMAGE_13_LINK_DUPLICATED:
          type: integer
          description: ad_image_13_link is duplicated with another ad image link.
        AD_IMAGE_14_LINK_DUPLICATED:
          type: integer
          description: ad_image_14_link is duplicated with another ad image link.
        AD_IMAGE_15_LINK_DUPLICATED:
          type: integer
          description: ad_image_15_link is duplicated with another ad image link.
        AD_IMAGE_16_LINK_DUPLICATED:
          type: integer
          description: ad_image_16_link is duplicated with another ad image link.
        AD_IMAGE_17_LINK_DUPLICATED:
          type: integer
          description: ad_image_17_link is duplicated with another ad image link.
        AD_IMAGE_18_LINK_DUPLICATED:
          type: integer
          description: ad_image_18_link is duplicated with another ad image link.
        AD_IMAGE_19_LINK_DUPLICATED:
          type: integer
          description: ad_image_19_link is duplicated with another ad image link.
        AD_IMAGE_0_TAG_DUPLICATED:
          type: integer
          description: ad_image_0_tag is duplicated with another ad image tag.
        AD_IMAGE_1_TAG_DUPLICATED:
          type: integer
          description: ad_image_1_tag is duplicated with another ad image tag.
        AD_IMAGE_2_TAG_DUPLICATED:
          type: integer
          description: ad_image_2_tag is duplicated with another ad image tag.
        AD_IMAGE_3_TAG_DUPLICATED:
          type: integer
          description: ad_image_3_tag is duplicated with another ad image tag.
        AD_IMAGE_4_TAG_DUPLICATED:
          type: integer
          description: ad_image_4_tag is duplicated with another ad image tag.
        AD_IMAGE_5_TAG_DUPLICATED:
          type: integer
          description: ad_image_5_tag is duplicated with another ad image tag.
        AD_IMAGE_6_TAG_DUPLICATED:
          type: integer
          description: ad_image_6_tag is duplicated with another ad image tag.
        AD_IMAGE_7_TAG_DUPLICATED:
          type: integer
          description: ad_image_7_tag is duplicated with another ad image tag.
        AD_IMAGE_8_TAG_DUPLICATED:
          type: integer
          description: ad_image_8_tag is duplicated with another ad image tag.
        AD_IMAGE_9_TAG_DUPLICATED:
          type: integer
          description: ad_image_9_tag is duplicated with another ad image tag.
        AD_IMAGE_10_TAG_DUPLICATED:
          type: integer
          description: ad_image_10_tag is duplicated with another ad image tag.
        AD_IMAGE_11_TAG_DUPLICATED:
          type: integer
          description: ad_image_11_tag is duplicated with another ad image tag.
        AD_IMAGE_12_TAG_DUPLICATED:
          type: integer
          description: ad_image_12_tag is duplicated with another ad image tag.
        AD_IMAGE_13_TAG_DUPLICATED:
          type: integer
          description: ad_image_13_tag is duplicated with another ad image tag.
        AD_IMAGE_14_TAG_DUPLICATED:
          type: integer
          description: ad_image_14_tag is duplicated with another ad image tag.
        AD_IMAGE_15_TAG_DUPLICATED:
          type: integer
          description: ad_image_15_tag is duplicated with another ad image tag.
        AD_IMAGE_16_TAG_DUPLICATED:
          type: integer
          description: ad_image_16_tag is duplicated with another ad image tag.
        AD_IMAGE_17_TAG_DUPLICATED:
          type: integer
          description: ad_image_17_tag is duplicated with another ad image tag.
        AD_IMAGE_18_TAG_DUPLICATED:
          type: integer
          description: ad_image_18_tag is duplicated with another ad image tag.
        AD_IMAGE_19_TAG_DUPLICATED:
          type: integer
          description: ad_image_19_tag is duplicated with another ad image tag.
        AD_VIDEO_0_LINK_LENGTH_TOO_LONG:
          type: integer
          description: ad_video_0_link length is too long. The maximum length is 511
            characters.
        AD_VIDEO_1_LINK_LENGTH_TOO_LONG:
          type: integer
          description: ad_video_1_link length is too long. The maximum length is 511
            characters.
        AD_VIDEO_2_LINK_LENGTH_TOO_LONG:
          type: integer
          description: ad_video_2_link length is too long. The maximum length is 511
            characters.
        AD_VIDEO_0_LINK_WARNING:
          type: integer
          description: ad_video_0_link is formatted incorrectly and will not be published
            with your items.
        AD_VIDEO_1_LINK_WARNING:
          type: integer
          description: ad_video_1_link is formatted incorrectly and will not be published
            with your items.
        AD_VIDEO_2_LINK_WARNING:
          type: integer
          description: ad_video_2_link is formatted incorrectly and will not be published
            with your items.
        AD_VIDEO_0_LINK_REQUIRED:
          type: integer
          description: ad_video_0_link is required for this item because ad_video_0_tag
            was provided.
        AD_VIDEO_1_LINK_REQUIRED:
          type: integer
          description: ad_video_1_link is required for this item because ad_video_1_tag
            was provided.
        AD_VIDEO_2_LINK_REQUIRED:
          type: integer
          description: ad_video_2_link is required for this item because ad_video_2_tag
            was provided.
        AD_VIDEO_0_LINK_DUPLICATED:
          type: integer
          description: ad_video_0_link is duplicated with another ad video link.
        AD_VIDEO_1_LINK_DUPLICATED:
          type: integer
          description: ad_video_1_link is duplicated with another ad video link.
        AD_VIDEO_2_LINK_DUPLICATED:
          type: integer
          description: ad_video_2_link is duplicated with another ad video link.
        AD_VIDEO_0_TAG_LENGTH_TOO_LONG:
          type: integer
          description: ad_video_0_tag length is too long. The maximum length is 511
            characters.
        AD_VIDEO_1_TAG_LENGTH_TOO_LONG:
          type: integer
          description: ad_video_1_tag length is too long. The maximum length is 511
            characters.
        AD_VIDEO_2_TAG_LENGTH_TOO_LONG:
          type: integer
          description: ad_video_2_tag length is too long. The maximum length is 511
            characters.
        AD_VIDEO_0_TAG_REQUIRED:
          type: integer
          description: ad_video_0_tag is required because ad_video_0_link was provided.
        AD_VIDEO_1_TAG_REQUIRED:
          type: integer
          description: ad_video_1_tag is required because ad_video_1_link was provided.
        AD_VIDEO_2_TAG_REQUIRED:
          type: integer
          description: ad_video_2_tag is required because ad_video_2_link was provided.
        AD_VIDEO_0_TAG_DUPLICATED:
          type: integer
          description: ad_video_0_tag is duplicated with another ad video tag.
        AD_VIDEO_1_TAG_DUPLICATED:
          type: integer
          description: ad_video_1_tag is duplicated with another ad video tag.
        AD_VIDEO_2_TAG_DUPLICATED:
          type: integer
          description: ad_video_2_tag is duplicated with another ad video tag.
        VIDEO_REQUIRED_WHEN_AD_VIDEO_PROVIDED:
          type: integer
          description: A video is required in the item when ad_video fields are provided.
        AD_LINK_FORMAT_WARNING:
          type: integer
          description: Some items have ad links that are formatted incorrectly.
        AD_LINK_SAME_AS_LINK:
          type: integer
          description: Some items have ad link URLs that are duplicates of the link
            URLs for those items.
        TITLE_LENGTH_TOO_LONG:
          type: integer
          description: The title for some items were truncated because they contain
            too many characters.
        DESCRIPTION_LENGTH_TOO_LONG:
          type: integer
          description: The description for some items were truncated because they
            contain too many characters.
        GENDER_INVALID:
          type: integer
          description: Some items have gender values that are formatted incorrectly,
            which may limit visibility in recommendations, search results and shopping
            experiences.
        AGE_GROUP_INVALID:
          type: integer
          description: Some items have age group values that are formatted incorrectly,
            which may limit visibility in recommendations, search results and shopping
            experiences.
        SIZE_TYPE_INVALID:
          type: integer
          description: Some items have size type values that are formatted incorrectly,
            which may limit visibility in recommendations, search results and shopping
            experiences.
        SIZE_SYSTEM_INVALID:
          type: integer
          description: Some items have size system values which are not one of the
            supported size systems.
        LINK_FORMAT_WARNING:
          type: integer
          description: Some items have an invalid product link which contains invalid
            UTM tracking paramaters.
        SALES_PRICE_INVALID:
          type: integer
          description: Some items have sale price values that are higher than the
            original price of the item.
        PRODUCT_CATEGORY_DEPTH_WARNING:
          type: integer
          description: Some items only have 1 or 2 levels of google_product_category
            values, which may limit visibility in recommendations, search results
            and shopping experiences.
        ADWORDS_FORMAT_WARNING:
          type: integer
          description: Some items have adwords_redirect links that are formatted incorrectly.
        ADWORDS_SAME_AS_LINK:
          type: integer
          description: Some items have adwords_redirect URLs that are duplicates of
            the link URLs for those items.
        DUPLICATE_HEADERS:
          type: integer
          description: Your feed contains duplicate headers.
        FETCH_SAME_SIGNATURE:
          type: integer
          description: Ingestion completed early because there are no changes to your
            feed since the last successful update.
          enum:
          - 1
        ADDITIONAL_IMAGE_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Some items have additional_image_link URLs that contain too
            many characters, so those items will not be published.
        ADDITIONAL_IMAGE_LINK_WARNING:
          type: integer
          description: Some items have additional_image_link URLs that are formatted
            incorrectly and will not be published with your items.
        IMAGE_LINK_WARNING:
          type: integer
          description: Some items have image_link URLs that are formatted incorrectly
            and will not be published with those items.
        SHIPPING_INVALID:
          type: integer
          description: Some items have shipping values that are formatted incorrectly.
        TAX_INVALID:
          type: integer
          description: Some items have tax values that are formatted incorrectly.
        SHIPPING_WEIGHT_INVALID:
          type: integer
          description: Some items have invalid shipping_weight values.
        EXPIRATION_DATE_INVALID:
          type: integer
          description: Some items have expiration_date values that are formatted incorrectly,
            those items will be published without an expiration date.
        AVAILABILITY_DATE_INVALID:
          type: integer
          description: Some items have availability_date values that are formatted
            incorrectly, those items will be published without an availability date.
        SALE_DATE_INVALID:
          type: integer
          description: Some items have sale_price_effective_date values that are formatted
            incorrectly, those items will be published without a sale date.
        WEIGHT_UNIT_INVALID:
          type: integer
          description: Some items have weight_unit values that are formatted incorrectly,
            those items will be published without a weight unit.
        IS_BUNDLE_INVALID:
          type: integer
          description: Some items have is_bundle values that are formatted incorrectly,
            those items will be published without being bundled with other products.
        UPDATED_TIME_INVALID:
          type: integer
          description: Some items have updated_time values thate are formatted incorrectly,
            those items will be published without an updated time.
        CUSTOM_LABEL_LENGTH_TOO_LONG:
          type: integer
          description: Some items have custom_label values that are too long, those
            items will be published without that custom label.
        PRODUCT_TYPE_LENGTH_TOO_LONG:
          type: integer
          description: Some items have product_type values that are too long, those
            items will be published without that product type.
        TOO_MANY_ADDITIONAL_IMAGE_LINKS:
          type: integer
          description: Some items have additional_image_link values that exceed the
            limit for additional images, those items will be published without some
            of your images.
        MULTIPACK_INVALID:
          type: integer
          description: Some items have invalid multipack values.
        INDEXED_PRODUCT_COUNT_LARGE_DELTA:
          type: integer
          description: The product count has increased or decreased significantly
            compared to the last successful ingestion.
        ITEM_ADDITIONAL_IMAGE_DOWNLOAD_FAILURE:
          type: integer
          description: Some items include additional_image_links that can't be found.
        OPTIONAL_PRODUCT_CATEGORY_MISSING:
          type: integer
          description: Some items are missing a google_product_category.
        OPTIONAL_PRODUCT_CATEGORY_INVALID:
          type: integer
          description: Some items include google_product_category values that are
            not formatted correctly according to the GPC taxonomy.
        OPTIONAL_CONDITION_MISSING:
          type: integer
          description: Some items are missing a condition value, which may limit visibility
            in recommendations, search results and shopping experiences.
        OPTIONAL_CONDITION_INVALID:
          type: integer
          description: Some items include condition values that are formatted incorrectly,
            which may limit visibility in recommendations, search results and shopping
            experiences.
        IOS_DEEP_LINK_INVALID:
          type: integer
          description: Some items include invalid ios_deep_link values.
        ANDROID_DEEP_LINK_INVALID:
          type: integer
          description: Some items include invalid android_deep_link.
        UTM_SOURCE_AUTO_CORRECTED:
          type: integer
          description: Some items include utm_source values that are formatted incorrectly
            and have been automatically corrected.
        COUNTRY_DOES_NOT_MAP_TO_CURRENCY:
          type: integer
          description: Some items include a currency that doesn't match the usual
            currency for the location where that product is sold or shipped.
        MIN_AD_PRICE_INVALID:
          type: integer
          description: Some items include min_ad_price values that are formatted incorrectly.
        GTIN_INVALID:
          type: integer
          description: Some items include incorrectly formatted GTINs.
        INCONSISTENT_CURRENCY_VALUES:
          type: integer
          description: Some items include inconsistent currencies in price fields.
        SALES_PRICE_TOO_LOW:
          type: integer
          description: Some items include sales price that is much lower than the
            list price.
        SHIPPING_WIDTH_INVALID:
          type: integer
          description: Some items include incorrectly formatted shipping_width.
        SHIPPING_HEIGHT_INVALID:
          type: integer
          description: Some items include incorrectly formatted shipping_height.
        SALES_PRICE_TOO_HIGH:
          type: integer
          description: Some items include a sales price that is higher than the list
            price. The sales price has been defaulted to the list price.
        MPN_INVALID:
          type: integer
          description: Some items include incorrectly formatted MPNs.
    CatalogsFeedsCreateRequest:
      type: object
      title: legacy_retail_only
      description: Request object for creating a feed. Please, be aware that "default_country"
        and "default_locale" are not required in the spec for forward compatibility
        but for now the API will not accept requests without those fields.
      additionalProperties: false
      properties:
        default_currency:
          $ref: '#/components/schemas/NullableCurrency'
        name:
          description: A human-friendly name associated to a given feed.
          type: string
        format:
          $ref: '#/components/schemas/CatalogsFormat'
        default_locale:
          description: The locale used within a feed for product descriptions.
          example: en-US
          anyOf:
          - description: The locale used within a feed for product descriptions.
            $ref: '#/components/schemas/CatalogsLocale'
          - description: The locale used within a feed for product descriptions. This
              free text string version is deprecated in favor of official list of
              supported locales defined by CatalogsLocale.
            type: string
            deprecated: true
        credentials:
          $ref: '#/components/schemas/CatalogsFeedCredentials'
        location:
          description: The URL where a feed is available for download. This URL is
            what Pinterest will use to download a feed for processing.
          pattern: ^(http|https|ftp|sftp)://
          type: string
        preferred_processing_schedule:
          $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
        default_country:
          $ref: '#/components/schemas/Country'
        default_availability:
          $ref: '#/components/schemas/ProductAvailabilityType'
        status:
          type: string
          allOf:
          - $ref: '#/components/schemas/CatalogsStatus'
          - default: ACTIVE
      required:
      - format
      - location
      - name
    CatalogsHotelAttributes:
      type: object
      allOf:
      - type: object
        properties:
          main_image:
            type: object
            description: The main hotel image
            properties:
              link:
                type: string
                description: |-
                  <p><= 2000 characters</p>
                  <p>The link to the main hotel image. Image should be at least
                  75x75 pixels to avoid errors. Use the additional_image_link field to add
                  more images of your hotel. The URL of your main_image.link must be accessible
                  by the Pinterest user-agent, and send the accurate image. Please make
                  sure there is no template or placeholder image at the link. Must start
                  with http:// or https://.</p>
              tag:
                type: array
                nullable: true
                description: Tag appended to the image that identifies image category
                  or details. There can be multiple tags associated with an image
                items:
                  type: string
          additional_image_link:
            type: array
            nullable: true
            items:
              type: string
            description: |-
              <p><= 2000 characters</p>
              <p>The links to additional images for your hotel. Up to ten
              additional images can be used to show a hotel from different angles.
              Must begin with http:// or https://.</p>
            example:
            - https://scene.example.com/image/image_v2.jpg
            - https://scene.example.com/image/image_v3.jpg
      - $ref: '#/components/schemas/CatalogsUpdatableHotelAttributes'
    CatalogsRetailFeedsCreateRequest:
      type: object
      title: feeds_retail_create_request
      description: Request object for creating a retail feed.
      additionalProperties: false
      properties:
        default_currency:
          $ref: '#/components/schemas/NullableCurrency'
        name:
          description: A human-friendly name associated to a given feed.
          type: string
        format:
          $ref: '#/components/schemas/CatalogsFormat'
        default_locale:
          description: The locale used within a feed for product descriptions.
          example: en-US
          anyOf:
          - description: The locale used within a feed for product descriptions.
            $ref: '#/components/schemas/CatalogsLocale'
          - description: The locale used within a feed for product descriptions. This
              free text string version is deprecated in favor of official list of
              supported locales defined by CatalogsLocale.
            type: string
            deprecated: true
        credentials:
          $ref: '#/components/schemas/CatalogsFeedCredentials'
        location:
          description: The URL where a feed is available for download. This URL is
            what Pinterest will use to download a feed for processing.
          pattern: ^(http|https|ftp|sftp)://
          type: string
        preferred_processing_schedule:
          $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        catalog_id:
          description: Catalog id pertaining to the feed. If not provided, feed will
            use a default catalog based on type. Currently, this field has no effect.
          type: string
          pattern: ^\d+$
        default_country:
          $ref: '#/components/schemas/Country'
        default_availability:
          $ref: '#/components/schemas/ProductAvailabilityType'
        status:
          type: string
          allOf:
          - $ref: '#/components/schemas/CatalogsStatus'
          - default: ACTIVE
      required:
      - format
      - location
      - name
      - catalog_type
      - default_country
      - default_locale
    CatalogsRetailItemsFilter:
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
        item_ids:
          type: array
          minItems: 1
          maxItems: 100
          items:
            type: string
        catalog_id:
          type: string
          pattern: ^\d+$
          description: Catalog id pertaining to the retail item. If not provided,
            default to oldest retail catalog
      required:
      - catalog_type
      - item_ids
    CatalogsRetailItemsPostFilter:
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
        item_ids:
          type: array
          minItems: 1
          maxItems: 1000
          items:
            type: string
        catalog_id:
          type: string
          pattern: ^\d+$
          description: Catalog id pertaining to the retail item. If not provided,
            default to oldest retail catalog
      required:
      - catalog_type
      - item_ids
    CatalogsHotelFeedsCreateRequest:
      type: object
      title: feeds_hotel_create_request
      description: Request object for creating a feed. Please, be aware that "default_country"
        and "default_locale" are not required in the spec for forward compatibility
        but for now the API will not accept requests without those fields.
      additionalProperties: false
      properties:
        default_currency:
          $ref: '#/components/schemas/NullableCurrency'
        name:
          description: A human-friendly name associated to a given feed.
          type: string
        format:
          $ref: '#/components/schemas/CatalogsFormat'
        default_locale:
          description: The locale used within a feed for product descriptions.
          example: en-US
          anyOf:
          - description: The locale used within a feed for product descriptions.
            $ref: '#/components/schemas/CatalogsLocale'
          - description: The locale used within a feed for product descriptions. This
              free text string version is deprecated in favor of official list of
              supported locales defined by CatalogsLocale.
            type: string
            deprecated: true
        credentials:
          $ref: '#/components/schemas/CatalogsFeedCredentials'
        location:
          description: The URL where a feed is available for download. This URL is
            what Pinterest will use to download a feed for processing.
          pattern: ^(http|https|ftp|sftp)://
          type: string
        preferred_processing_schedule:
          $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        catalog_id:
          description: Catalog id pertaining to the feed. If not provided, feed will
            use a default catalog based on type. At the moment a catalog can not have
            multiple hotel feeds but this will change in the future.
          type: string
          pattern: ^\d+$
        status:
          type: string
          allOf:
          - $ref: '#/components/schemas/CatalogsStatus'
          - default: ACTIVE
      required:
      - format
      - location
      - name
      - catalog_type
      - default_locale
    CatalogsHotelItemsFilter:
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        hotel_ids:
          type: array
          minItems: 1
          maxItems: 100
          items:
            type: string
        catalog_id:
          type: string
          pattern: ^\d+$
          description: Catalog id pertaining to the hotel item. If not provided, default
            to oldest hotel catalog
      required:
      - catalog_type
      - hotel_ids
    CatalogsHotelItemsPostFilter:
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        hotel_ids:
          type: array
          minItems: 1
          maxItems: 1000
          items:
            type: string
        catalog_id:
          type: string
          pattern: ^\d+$
          description: Catalog id pertaining to the hotel item. If not provided, default
            to oldest hotel catalog
      required:
      - catalog_type
      - hotel_ids
    CatalogsCreativeAssetsItemsFilter:
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        creative_assets_ids:
          type: array
          minItems: 1
          maxItems: 100
          items:
            type: string
        catalog_id:
          type: string
          pattern: ^\d+$
          description: Catalog id pertaining to the creative assets item. If not provided,
            default to oldest creative assets catalog
      required:
      - catalog_type
      - creative_assets_ids
    CatalogsCreativeAssetsItemsPostFilter:
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        creative_assets_ids:
          type: array
          minItems: 1
          maxItems: 1000
          items:
            type: string
        catalog_id:
          type: string
          pattern: ^\d+$
          description: Catalog id pertaining to the creative assets item. If not provided,
            default to oldest creative assets catalog
      required:
      - catalog_type
      - creative_assets_ids
    CatalogsCreativeAssetsFeedsCreateRequest:
      type: object
      title: feeds_creative_assets_create_request
      description: Request object for creating a feed.
      additionalProperties: false
      properties:
        default_currency:
          $ref: '#/components/schemas/NullableCurrency'
        name:
          description: A human-friendly name associated to a given feed.
          type: string
        format:
          $ref: '#/components/schemas/CatalogsFormat'
        default_locale:
          description: The locale used within a feed for product descriptions.
          example: en-US
          anyOf:
          - description: The locale used within a feed for product descriptions.
            $ref: '#/components/schemas/CatalogsLocale'
          - description: The locale used within a feed for product descriptions. This
              free text string version is deprecated in favor of official list of
              supported locales defined by CatalogsLocale.
            type: string
            deprecated: true
        default_country:
          $ref: '#/components/schemas/Country'
        credentials:
          $ref: '#/components/schemas/CatalogsFeedCredentials'
        location:
          description: The URL where a feed is available for download. This URL is
            what Pinterest will use to download a feed for processing.
          pattern: ^(http|https|ftp|sftp)://
          type: string
        preferred_processing_schedule:
          $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        catalog_id:
          description: Catalog id pertaining to the feed. If not provided, feed will
            use a default catalog based on type. At the moment a catalog can not have
            multiple creative assets feeds but this will change in the future.
          type: string
          pattern: ^\d+$
        status:
          type: string
          allOf:
          - $ref: '#/components/schemas/CatalogsStatus'
          - default: ACTIVE
      required:
      - format
      - location
      - name
      - catalog_type
      - default_country
      - default_locale
    CatalogsVerticalFeedsCreateRequest:
      type: object
      title: feeds_create_request
      description: Request object for creating a feed.
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailFeedsCreateRequest'
      - $ref: '#/components/schemas/CatalogsHotelFeedsCreateRequest'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsFeedsCreateRequest'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailFeedsCreateRequest'
          HOTEL: '#/components/schemas/CatalogsHotelFeedsCreateRequest'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsFeedsCreateRequest'
    CatalogsCreativeAssetsFeedsUpdateRequest:
      type: object
      title: catalogs_feeds_update_request
      description: Request object for updating a feed.
      additionalProperties: false
      properties:
        default_currency:
          $ref: '#/components/schemas/NullableCurrency'
        name:
          description: A human-friendly name associated to a given feed.
          type: string
        format:
          $ref: '#/components/schemas/CatalogsFormat'
        credentials:
          $ref: '#/components/schemas/CatalogsFeedCredentials'
        location:
          type: string
          pattern: ^(http|https|ftp|sftp)://
          description: The URL where a feed is available for download. This URL is
            what Pinterest will use to download a feed for processing.
        preferred_processing_schedule:
          $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
        status:
          $ref: '#/components/schemas/CatalogsStatus'
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
      required:
      - catalog_type
    CatalogsRetailFeedsUpdateRequest:
      type: object
      title: catalogs_feeds_update_request
      description: Request object for updating a feed.
      additionalProperties: false
      properties:
        default_currency:
          $ref: '#/components/schemas/NullableCurrency'
        name:
          description: A human-friendly name associated to a given feed.
          type: string
        format:
          $ref: '#/components/schemas/CatalogsFormat'
        credentials:
          $ref: '#/components/schemas/CatalogsFeedCredentials'
        location:
          type: string
          pattern: ^(http|https|ftp|sftp)://
          description: The URL where a feed is available for download. This URL is
            what Pinterest will use to download a feed for processing.
        preferred_processing_schedule:
          $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
        status:
          $ref: '#/components/schemas/CatalogsStatus'
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        default_availability:
          $ref: '#/components/schemas/ProductAvailabilityType'
      required:
      - catalog_type
    CatalogsHotelFeedsUpdateRequest:
      type: object
      title: catalogs_feeds_update_request
      description: Request object for updating a feed.
      additionalProperties: false
      properties:
        default_currency:
          $ref: '#/components/schemas/NullableCurrency'
        name:
          description: A human-friendly name associated to a given feed.
          type: string
        format:
          $ref: '#/components/schemas/CatalogsFormat'
        credentials:
          $ref: '#/components/schemas/CatalogsFeedCredentials'
        location:
          type: string
          pattern: ^(http|https|ftp|sftp)://
          description: The URL where a feed is available for download. This URL is
            what Pinterest will use to download a feed for processing.
        preferred_processing_schedule:
          $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
        status:
          $ref: '#/components/schemas/CatalogsStatus'
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
      required:
      - catalog_type
    CatalogsVerticalFeedsUpdateRequest:
      type: object
      title: feeds_update_request
      description: Request object for updating a feed.
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailFeedsUpdateRequest'
      - $ref: '#/components/schemas/CatalogsHotelFeedsUpdateRequest'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsFeedsUpdateRequest'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailFeedsUpdateRequest'
          HOTEL: '#/components/schemas/CatalogsHotelFeedsUpdateRequest'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsFeedsUpdateRequest'
    CatalogsFeedsUpdateRequest:
      type: object
      title: legacy_retail_only
      description: Request object for updating a feed.
      additionalProperties: false
      properties:
        default_availability:
          $ref: '#/components/schemas/ProductAvailabilityType'
        default_currency:
          $ref: '#/components/schemas/NullableCurrency'
        name:
          description: A human-friendly name associated to a given feed.
          type: string
        format:
          $ref: '#/components/schemas/CatalogsFormat'
        credentials:
          $ref: '#/components/schemas/CatalogsFeedCredentials'
        location:
          type: string
          pattern: ^(http|https|ftp|sftp)://
          description: The URL where a feed is available for download. This URL is
            what Pinterest will use to download a feed for processing.
        preferred_processing_schedule:
          $ref: '#/components/schemas/CatalogsFeedProcessingSchedule'
        status:
          $ref: '#/components/schemas/CatalogsStatus'
    CatalogsFormat:
      description: The file format of a feed.
      type: string
      enum:
      - TSV
      - CSV
      - XML
    CatalogsItemValidationDetails:
      type: object
      properties:
        attribute_name:
          $ref: '#/components/schemas/NullableCatalogsItemFieldType'
          description: Attribute that has a validation issue.
        provided_value:
          type: string
          nullable: true
          description: Provided value that caused the validation issue.
      required:
      - attribute_name
      - provided_value
    CatalogsItemValidationErrors:
      type: object
      properties:
        ADULT_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an invalid adult value.
        ADWORDS_FORMAT_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Adword link contains too many characters.
        AVAILABILITY_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing availability value in its product metadata,
            this item will not be published.
        BLOCKLISTED_IMAGE_SIGNATURE:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item will not be published because it doesn't meet Pinterest's
            Merchant Guidelines.
        DESCRIPTION_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing description in its product metadata, this item
            will not be published.
        DUPLICATE_PRODUCTS:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: This product is duplicated. The duplicate entry will not be
            published.
        IMAGE_LINK_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Image link is invalid.
        IMAGE_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has image_link URL that contains too many characters,
            so the item will not be published.
        IMAGE_LINK_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing an image link URL in its product metadata,
            this item will not be published.
        INVALID_DOMAIN:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Product link value doesn't match the verified domain associated
            with this account.
        ITEMID_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing item id in its product metadata, this item
            will not be published.
        ITEM_MAIN_IMAGE_DOWNLOAD_FAILURE:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Main image can't be found.
        LINK_FORMAT_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Link is invalid.
        LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Product link contains too many characters, this item will not
            be published.
        LIST_PRICE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a list price formatting error, this item will not
            be published.
        MAX_ITEMS_PER_ITEM_GROUP_EXCEEDED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item exceed the maximum number of items per item group, this
            item will not be published.
        PARSE_LINE_ERROR:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item contains formating errors.
        PINJOIN_CONTENT_UNSAFE:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item will not be published because it doesn't meet Pinterest's
            Merchant Guidelines.
        PRICE_CANNOT_BE_DETERMINED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item price cannot be determined because the price, list price,
            and sale price are all different.
        PRICE_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Product is missing a price, this item will not be published.
        PRODUCT_LINK_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing a link URL in its product metadata, this item
            will not be published.
        PRODUCT_PRICE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a price formatting error in its product metadata,
            this item will not be published.
        TITLE_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing title in its product metadata, this item will
            not be published.
    CatalogsItemValidationIssue:
      type: string
      enum:
      - AD_IMAGE_0_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_1_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_2_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_3_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_4_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_5_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_6_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_7_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_8_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_9_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_10_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_11_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_12_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_13_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_14_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_15_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_16_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_17_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_18_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_19_LINK_LENGTH_TOO_LONG
      - AD_IMAGE_0_LINK_WARNING
      - AD_IMAGE_1_LINK_WARNING
      - AD_IMAGE_2_LINK_WARNING
      - AD_IMAGE_3_LINK_WARNING
      - AD_IMAGE_4_LINK_WARNING
      - AD_IMAGE_5_LINK_WARNING
      - AD_IMAGE_6_LINK_WARNING
      - AD_IMAGE_7_LINK_WARNING
      - AD_IMAGE_8_LINK_WARNING
      - AD_IMAGE_9_LINK_WARNING
      - AD_IMAGE_10_LINK_WARNING
      - AD_IMAGE_11_LINK_WARNING
      - AD_IMAGE_12_LINK_WARNING
      - AD_IMAGE_13_LINK_WARNING
      - AD_IMAGE_14_LINK_WARNING
      - AD_IMAGE_15_LINK_WARNING
      - AD_IMAGE_16_LINK_WARNING
      - AD_IMAGE_17_LINK_WARNING
      - AD_IMAGE_18_LINK_WARNING
      - AD_IMAGE_19_LINK_WARNING
      - AD_IMAGE_0_LINK_REQUIRED
      - AD_IMAGE_1_LINK_REQUIRED
      - AD_IMAGE_2_LINK_REQUIRED
      - AD_IMAGE_3_LINK_REQUIRED
      - AD_IMAGE_4_LINK_REQUIRED
      - AD_IMAGE_5_LINK_REQUIRED
      - AD_IMAGE_6_LINK_REQUIRED
      - AD_IMAGE_7_LINK_REQUIRED
      - AD_IMAGE_8_LINK_REQUIRED
      - AD_IMAGE_9_LINK_REQUIRED
      - AD_IMAGE_10_LINK_REQUIRED
      - AD_IMAGE_11_LINK_REQUIRED
      - AD_IMAGE_12_LINK_REQUIRED
      - AD_IMAGE_13_LINK_REQUIRED
      - AD_IMAGE_14_LINK_REQUIRED
      - AD_IMAGE_15_LINK_REQUIRED
      - AD_IMAGE_16_LINK_REQUIRED
      - AD_IMAGE_17_LINK_REQUIRED
      - AD_IMAGE_18_LINK_REQUIRED
      - AD_IMAGE_19_LINK_REQUIRED
      - AD_IMAGE_0_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_1_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_2_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_3_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_4_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_5_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_6_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_7_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_8_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_9_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_10_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_11_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_12_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_13_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_14_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_15_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_16_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_17_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_18_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_19_TAG_LENGTH_TOO_LONG
      - AD_IMAGE_0_TAG_REQUIRED
      - AD_IMAGE_1_TAG_REQUIRED
      - AD_IMAGE_2_TAG_REQUIRED
      - AD_IMAGE_3_TAG_REQUIRED
      - AD_IMAGE_4_TAG_REQUIRED
      - AD_IMAGE_5_TAG_REQUIRED
      - AD_IMAGE_6_TAG_REQUIRED
      - AD_IMAGE_7_TAG_REQUIRED
      - AD_IMAGE_8_TAG_REQUIRED
      - AD_IMAGE_9_TAG_REQUIRED
      - AD_IMAGE_10_TAG_REQUIRED
      - AD_IMAGE_11_TAG_REQUIRED
      - AD_IMAGE_12_TAG_REQUIRED
      - AD_IMAGE_13_TAG_REQUIRED
      - AD_IMAGE_14_TAG_REQUIRED
      - AD_IMAGE_15_TAG_REQUIRED
      - AD_IMAGE_16_TAG_REQUIRED
      - AD_IMAGE_17_TAG_REQUIRED
      - AD_IMAGE_18_TAG_REQUIRED
      - AD_IMAGE_19_TAG_REQUIRED
      - AD_IMAGE_0_LINK_DUPLICATED
      - AD_IMAGE_1_LINK_DUPLICATED
      - AD_IMAGE_2_LINK_DUPLICATED
      - AD_IMAGE_3_LINK_DUPLICATED
      - AD_IMAGE_4_LINK_DUPLICATED
      - AD_IMAGE_5_LINK_DUPLICATED
      - AD_IMAGE_6_LINK_DUPLICATED
      - AD_IMAGE_7_LINK_DUPLICATED
      - AD_IMAGE_8_LINK_DUPLICATED
      - AD_IMAGE_9_LINK_DUPLICATED
      - AD_IMAGE_10_LINK_DUPLICATED
      - AD_IMAGE_11_LINK_DUPLICATED
      - AD_IMAGE_12_LINK_DUPLICATED
      - AD_IMAGE_13_LINK_DUPLICATED
      - AD_IMAGE_14_LINK_DUPLICATED
      - AD_IMAGE_15_LINK_DUPLICATED
      - AD_IMAGE_16_LINK_DUPLICATED
      - AD_IMAGE_17_LINK_DUPLICATED
      - AD_IMAGE_18_LINK_DUPLICATED
      - AD_IMAGE_19_LINK_DUPLICATED
      - AD_IMAGE_0_TAG_DUPLICATED
      - AD_IMAGE_1_TAG_DUPLICATED
      - AD_IMAGE_2_TAG_DUPLICATED
      - AD_IMAGE_3_TAG_DUPLICATED
      - AD_IMAGE_4_TAG_DUPLICATED
      - AD_IMAGE_5_TAG_DUPLICATED
      - AD_IMAGE_6_TAG_DUPLICATED
      - AD_IMAGE_7_TAG_DUPLICATED
      - AD_IMAGE_8_TAG_DUPLICATED
      - AD_IMAGE_9_TAG_DUPLICATED
      - AD_IMAGE_10_TAG_DUPLICATED
      - AD_IMAGE_11_TAG_DUPLICATED
      - AD_IMAGE_12_TAG_DUPLICATED
      - AD_IMAGE_13_TAG_DUPLICATED
      - AD_IMAGE_14_TAG_DUPLICATED
      - AD_IMAGE_15_TAG_DUPLICATED
      - AD_IMAGE_16_TAG_DUPLICATED
      - AD_IMAGE_17_TAG_DUPLICATED
      - AD_IMAGE_18_TAG_DUPLICATED
      - AD_IMAGE_19_TAG_DUPLICATED
      - AD_VIDEO_0_LINK_LENGTH_TOO_LONG
      - AD_VIDEO_1_LINK_LENGTH_TOO_LONG
      - AD_VIDEO_2_LINK_LENGTH_TOO_LONG
      - AD_VIDEO_0_LINK_WARNING
      - AD_VIDEO_1_LINK_WARNING
      - AD_VIDEO_2_LINK_WARNING
      - AD_VIDEO_0_LINK_REQUIRED
      - AD_VIDEO_1_LINK_REQUIRED
      - AD_VIDEO_2_LINK_REQUIRED
      - AD_VIDEO_0_LINK_DUPLICATED
      - AD_VIDEO_1_LINK_DUPLICATED
      - AD_VIDEO_2_LINK_DUPLICATED
      - AD_VIDEO_0_TAG_LENGTH_TOO_LONG
      - AD_VIDEO_1_TAG_LENGTH_TOO_LONG
      - AD_VIDEO_2_TAG_LENGTH_TOO_LONG
      - AD_VIDEO_0_TAG_REQUIRED
      - AD_VIDEO_1_TAG_REQUIRED
      - AD_VIDEO_2_TAG_REQUIRED
      - AD_VIDEO_0_TAG_DUPLICATED
      - AD_VIDEO_1_TAG_DUPLICATED
      - AD_VIDEO_2_TAG_DUPLICATED
      - VIDEO_REQUIRED_WHEN_AD_VIDEO_PROVIDED
      - AD_LINK_FORMAT_WARNING
      - AD_LINK_SAME_AS_LINK
      - ADDITIONAL_IMAGE_LINK_LENGTH_TOO_LONG
      - ADDITIONAL_IMAGE_LINK_WARNING
      - ADULT_INVALID
      - ADWORDS_FORMAT_INVALID
      - ADWORDS_FORMAT_WARNING
      - ADWORDS_SAME_AS_LINK
      - AGE_GROUP_INVALID
      - ANDROID_DEEP_LINK_INVALID
      - AVAILABILITY_DATE_INVALID
      - AVAILABILITY_INVALID
      - BLOCKLISTED_IMAGE_SIGNATURE
      - COUNTRY_DOES_NOT_MAP_TO_CURRENCY
      - CUSTOM_LABEL_LENGTH_TOO_LONG
      - DESCRIPTION_LENGTH_TOO_LONG
      - DESCRIPTION_MISSING
      - DUPLICATE_PRODUCTS
      - EXPIRATION_DATE_INVALID
      - GENDER_INVALID
      - GTIN_INVALID
      - IMAGE_LINK_INVALID
      - IMAGE_LINK_LENGTH_TOO_LONG
      - IMAGE_LINK_MISSING
      - IMAGE_LINK_WARNING
      - INVALID_DOMAIN
      - IOS_DEEP_LINK_INVALID
      - IS_BUNDLE_INVALID
      - ITEM_ADDITIONAL_IMAGE_DOWNLOAD_FAILURE
      - ITEM_MAIN_IMAGE_DOWNLOAD_FAILURE
      - ITEMID_MISSING
      - LINK_FORMAT_INVALID
      - LINK_FORMAT_WARNING
      - LINK_LENGTH_TOO_LONG
      - LIST_PRICE_INVALID
      - MAX_ITEMS_PER_ITEM_GROUP_EXCEEDED
      - MIN_AD_PRICE_INVALID
      - MPN_INVALID
      - MULTIPACK_INVALID
      - OPTIONAL_CONDITION_INVALID
      - OPTIONAL_CONDITION_MISSING
      - OPTIONAL_PRODUCT_CATEGORY_INVALID
      - OPTIONAL_PRODUCT_CATEGORY_MISSING
      - PARSE_LINE_ERROR
      - PINJOIN_CONTENT_UNSAFE
      - PRICE_CANNOT_BE_DETERMINED
      - PRICE_MISSING
      - PRODUCT_CATEGORY_DEPTH_WARNING
      - PRODUCT_LINK_MISSING
      - PRODUCT_PRICE_INVALID
      - PRODUCT_TYPE_LENGTH_TOO_LONG
      - SALE_DATE_INVALID
      - SALES_PRICE_INVALID
      - SALES_PRICE_TOO_HIGH
      - SALES_PRICE_TOO_LOW
      - SHIPPING_INVALID
      - SHIPPING_HEIGHT_INVALID
      - SHIPPING_WEIGHT_INVALID
      - SHIPPING_WIDTH_INVALID
      - SIZE_SYSTEM_INVALID
      - SIZE_TYPE_INVALID
      - TAX_INVALID
      - TITLE_LENGTH_TOO_LONG
      - TITLE_MISSING
      - TOO_MANY_ADDITIONAL_IMAGE_LINKS
      - UTM_SOURCE_AUTO_CORRECTED
      - WEIGHT_UNIT_INVALID
    CatalogsItemValidationIssues:
      type: object
      properties:
        item_number:
          description: Item number based on order of appearance in the Catalogs Feed.
            For example, '0' refers to first item found in a feed that was downloaded
            from a 'location' specified during feed creation.
          example: 0
          type: integer
        item_id:
          description: The merchant-created unique ID that represents the product.
          example: DS0294-L
          type: string
          nullable: true
        errors:
          $ref: '#/components/schemas/CatalogsItemValidationErrors'
        warnings:
          $ref: '#/components/schemas/CatalogsItemValidationWarnings'
      required:
      - item_number
      - item_id
      - errors
      - warnings
    CatalogsItemValidationWarnings:
      type: object
      properties:
        AD_IMAGE_0_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 0 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_1_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 1 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_2_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 2 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_3_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 3 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_4_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 4 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_5_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 5 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_6_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 6 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_7_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 7 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_8_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 8 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_9_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 9 length is too long. The maximum length is 2047
            characters.
        AD_IMAGE_10_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 10 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_11_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 11 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_12_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 12 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_13_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 13 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_14_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 14 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_15_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 15 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_16_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 16 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_17_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 17 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_18_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 18 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_19_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 19 length is too long. The maximum length is
            2047 characters.
        AD_IMAGE_0_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 0 format is unsupported.
        AD_IMAGE_1_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 1 format is unsupported.
        AD_IMAGE_2_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 2 format is unsupported.
        AD_IMAGE_3_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 3 format is unsupported.
        AD_IMAGE_4_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 4 format is unsupported.
        AD_IMAGE_5_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 5 format is unsupported.
        AD_IMAGE_6_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 6 format is unsupported.
        AD_IMAGE_7_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 7 format is unsupported.
        AD_IMAGE_8_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 8 format is unsupported.
        AD_IMAGE_9_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 9 format is unsupported.
        AD_IMAGE_10_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 10 format is unsupported.
        AD_IMAGE_11_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 11 format is unsupported.
        AD_IMAGE_12_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 12 format is unsupported.
        AD_IMAGE_13_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 13 format is unsupported.
        AD_IMAGE_14_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 14 format is unsupported.
        AD_IMAGE_15_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 15 format is unsupported.
        AD_IMAGE_16_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 16 format is unsupported.
        AD_IMAGE_17_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 17 format is unsupported.
        AD_IMAGE_18_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 18 format is unsupported.
        AD_IMAGE_19_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 19 format is unsupported.
        AD_IMAGE_0_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 0 is required because an image tag was provided.
        AD_IMAGE_1_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 1 is required because an image tag was provided.
        AD_IMAGE_2_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 2 is required because an image tag was provided.
        AD_IMAGE_3_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 3 is required because an image tag was provided.
        AD_IMAGE_4_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 4 is required because an image tag was provided.
        AD_IMAGE_5_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 5 is required because an image tag was provided.
        AD_IMAGE_6_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 6 is required because an image tag was provided.
        AD_IMAGE_7_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 7 is required because an image tag was provided.
        AD_IMAGE_8_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 8 is required because an image tag was provided.
        AD_IMAGE_9_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 9 is required because an image tag was provided.
        AD_IMAGE_10_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 10 is required because an image tag was provided.
        AD_IMAGE_11_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 11 is required because an image tag was provided.
        AD_IMAGE_12_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 12 is required because an image tag was provided.
        AD_IMAGE_13_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 13 is required because an image tag was provided.
        AD_IMAGE_14_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 14 is required because an image tag was provided.
        AD_IMAGE_15_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 15 is required because an image tag was provided.
        AD_IMAGE_16_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 16 is required because an image tag was provided.
        AD_IMAGE_17_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 17 is required because an image tag was provided.
        AD_IMAGE_18_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 18 is required because an image tag was provided.
        AD_IMAGE_19_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image link 19 is required because an image tag was provided.
        AD_IMAGE_0_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 0 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_1_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 1 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_2_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 2 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_3_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 3 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_4_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 4 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_5_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 5 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_6_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 6 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_7_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 7 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_8_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 8 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_9_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 9 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_10_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 10 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_11_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 11 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_12_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 12 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_13_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 13 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_14_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 14 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_15_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 15 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_16_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 16 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_17_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 17 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_18_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 18 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_19_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 19 length is too long. The maximum length is 511
            characters.
        AD_IMAGE_0_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 0 is required because an image link was provided.
        AD_IMAGE_1_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 1 is required because an image link was provided.
        AD_IMAGE_2_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 2 is required because an image link was provided.
        AD_IMAGE_3_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 3 is required because an image link was provided.
        AD_IMAGE_4_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 4 is required because an image link was provided.
        AD_IMAGE_5_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 5 is required because an image link was provided.
        AD_IMAGE_6_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 6 is required because an image link was provided.
        AD_IMAGE_7_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 7 is required because an image link was provided.
        AD_IMAGE_8_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 8 is required because an image link was provided.
        AD_IMAGE_9_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 9 is required because an image link was provided.
        AD_IMAGE_10_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 10 is required because an image link was provided.
        AD_IMAGE_11_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 11 is required because an image link was provided.
        AD_IMAGE_12_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 12 is required because an image link was provided.
        AD_IMAGE_13_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 13 is required because an image link was provided.
        AD_IMAGE_14_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 14 is required because an image link was provided.
        AD_IMAGE_15_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 15 is required because an image link was provided.
        AD_IMAGE_16_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 16 is required because an image link was provided.
        AD_IMAGE_17_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 17 is required because an image link was provided.
        AD_IMAGE_18_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 18 is required because an image link was provided.
        AD_IMAGE_19_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Ad image tag 19 is required because an image link was provided.
        AD_IMAGE_0_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_0_link is duplicated with another ad image link.
        AD_IMAGE_1_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_1_link is duplicated with another ad image link.
        AD_IMAGE_2_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_2_link is duplicated with another ad image link.
        AD_IMAGE_3_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_3_link is duplicated with another ad image link.
        AD_IMAGE_4_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_4_link is duplicated with another ad image link.
        AD_IMAGE_5_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_5_link is duplicated with another ad image link.
        AD_IMAGE_6_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_6_link is duplicated with another ad image link.
        AD_IMAGE_7_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_7_link is duplicated with another ad image link.
        AD_IMAGE_8_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_8_link is duplicated with another ad image link.
        AD_IMAGE_9_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_9_link is duplicated with another ad image link.
        AD_IMAGE_10_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_10_link is duplicated with another ad image link.
        AD_IMAGE_11_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_11_link is duplicated with another ad image link.
        AD_IMAGE_12_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_12_link is duplicated with another ad image link.
        AD_IMAGE_13_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_13_link is duplicated with another ad image link.
        AD_IMAGE_14_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_14_link is duplicated with another ad image link.
        AD_IMAGE_15_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_15_link is duplicated with another ad image link.
        AD_IMAGE_16_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_16_link is duplicated with another ad image link.
        AD_IMAGE_17_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_17_link is duplicated with another ad image link.
        AD_IMAGE_18_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_18_link is duplicated with another ad image link.
        AD_IMAGE_19_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_19_link is duplicated with another ad image link.
        AD_IMAGE_0_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_0_tag is duplicated with another ad image tag.
        AD_IMAGE_1_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_1_tag is duplicated with another ad image tag.
        AD_IMAGE_2_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_2_tag is duplicated with another ad image tag.
        AD_IMAGE_3_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_3_tag is duplicated with another ad image tag.
        AD_IMAGE_4_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_4_tag is duplicated with another ad image tag.
        AD_IMAGE_5_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_5_tag is duplicated with another ad image tag.
        AD_IMAGE_6_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_6_tag is duplicated with another ad image tag.
        AD_IMAGE_7_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_7_tag is duplicated with another ad image tag.
        AD_IMAGE_8_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_8_tag is duplicated with another ad image tag.
        AD_IMAGE_9_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_9_tag is duplicated with another ad image tag.
        AD_IMAGE_10_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_10_tag is duplicated with another ad image tag.
        AD_IMAGE_11_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_11_tag is duplicated with another ad image tag.
        AD_IMAGE_12_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_12_tag is duplicated with another ad image tag.
        AD_IMAGE_13_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_13_tag is duplicated with another ad image tag.
        AD_IMAGE_14_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_14_tag is duplicated with another ad image tag.
        AD_IMAGE_15_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_15_tag is duplicated with another ad image tag.
        AD_IMAGE_16_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_16_tag is duplicated with another ad image tag.
        AD_IMAGE_17_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_17_tag is duplicated with another ad image tag.
        AD_IMAGE_18_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_18_tag is duplicated with another ad image tag.
        AD_IMAGE_19_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_image_19_tag is duplicated with another ad image tag.
        AD_VIDEO_0_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_0_link length is too long. The maximum length is 511
            characters.
        AD_VIDEO_1_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_1_link length is too long. The maximum length is 511
            characters.
        AD_VIDEO_2_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_2_link length is too long. The maximum length is 511
            characters.
        AD_VIDEO_0_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_0_link is formatted incorrectly and will not be published
            with your items.
        AD_VIDEO_1_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_1_link is formatted incorrectly and will not be published
            with your items.
        AD_VIDEO_2_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_2_link is formatted incorrectly and will not be published
            with your items.
        AD_VIDEO_0_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_0_link is required for this item because ad_video_0_tag
            was provided.
        AD_VIDEO_1_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_1_link is required for this item because ad_video_1_tag
            was provided.
        AD_VIDEO_2_LINK_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_2_link is required for this item because ad_video_2_tag
            was provided.
        AD_VIDEO_0_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_0_link is duplicated with another ad video link.
        AD_VIDEO_1_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_1_link is duplicated with another ad video link.
        AD_VIDEO_2_LINK_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_2_link is duplicated with another ad video link.
        AD_VIDEO_0_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_0_tag length is too long. The maximum length is 511
            characters.
        AD_VIDEO_1_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_1_tag length is too long. The maximum length is 511
            characters.
        AD_VIDEO_2_TAG_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_2_tag length is too long. The maximum length is 511
            characters.
        AD_VIDEO_0_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_0_tag is required because ad_video_0_link was provided.
        AD_VIDEO_1_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_1_tag is required because ad_video_1_link was provided.
        AD_VIDEO_2_TAG_REQUIRED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_2_tag is required because ad_video_2_link was provided.
        AD_VIDEO_0_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_0_tag is duplicated with another ad video tag.
        AD_VIDEO_1_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_1_tag is duplicated with another ad video tag.
        AD_VIDEO_2_TAG_DUPLICATED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: ad_video_2_tag is duplicated with another ad video tag.
        VIDEO_REQUIRED_WHEN_AD_VIDEO_PROVIDED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: A video is required in the item when ad_video fields are provided.
        AD_LINK_FORMAT_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an ad link that is formatted incorrectly.
        AD_LINK_SAME_AS_LINK:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an ad link URL that is duplicate of the link URL.
        ADDITIONAL_IMAGE_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an additional_image_link URL that contains too many
            characters, so the item will not be published.
        ADDITIONAL_IMAGE_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has additional_image_link URLs that are formatted incorrectly
            and will not be published with your items.
        ADWORDS_FORMAT_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an adwords_redirect link that is formatted incorrectly.
        ADWORDS_SAME_AS_LINK:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an adwords_redirect URL that is duplicate of the link
            URL.
        AGE_GROUP_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an age group value that is formatted incorrectly,
            which may limit visibility in recommendations, search results and shopping
            experiences.
        SIZE_SYSTEM_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Some items have size system values which are not one of the
            supported size systems.
        ANDROID_DEEP_LINK_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes an invalid android_deep_link.
        AVAILABILITY_DATE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an availability_date value that is formatted incorrectly,
            this item will be published without an availability date.
        COUNTRY_DOES_NOT_MAP_TO_CURRENCY:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes a currency that doesn't match the usual currency
            for the location where the product is sold or shipped.
        CUSTOM_LABEL_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a custom_label value that is too long, this item will
            be published without that custom label.
        DESCRIPTION_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: The description for this item was truncated because it contains
            too many characters.
        EXPIRATION_DATE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an expiration_date value that is formatted incorrectly,
            this item will be published without an expiration date.
        GENDER_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a gender value that is formatted incorrectly, which
            may limit visibility in recommendations, search results and shopping experiences.
        GTIN_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a GTIN value that is formatted incorrectly.
        IMAGE_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an image_link URL that is formatted incorrectly and
            will not be published.
        IOS_DEEP_LINK_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes an invalid ios_deep_link value.
        IS_BUNDLE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an is_bundle value that is formatted incorrectly,
            this item will be published without being bundled with other products.
        ITEM_ADDITIONAL_IMAGE_DOWNLOAD_FAILURE:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes additional_image_links that can't be found.
        LINK_FORMAT_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an invalid product link which contains invalid UTM
            tracking paramaters.
        MIN_AD_PRICE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes a min_ad_price value that is formatted incorrectly.
        MPN_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a MPN value that is formatted incorrectly.
        MULTIPACK_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an invalid multipack value.
        OPTIONAL_CONDITION_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes a condition value that is formatted incorrectly,
            which may limit visibility in recommendations, search results and shopping
            experiences.
        OPTIONAL_CONDITION_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing condition value, which may limit visibility
            in recommendations, search results and shopping experiences.
        OPTIONAL_PRODUCT_CATEGORY_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes a google_product_category value that is not formatted
            correctly according to the GPC taxonomy.
        OPTIONAL_PRODUCT_CATEGORY_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing google_product_category.
        PRODUCT_CATEGORY_DEPTH_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item only has 1 or 2 levels of google_product_category value,
            which may limit visibility in recommendations, search results and shopping
            experiences.
        PRODUCT_TYPE_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a product_type value that is too long, this item will
            be published without that product type.
        SALES_PRICE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an incorrectly formatted sales price.
        SALES_PRICE_TOO_LOW:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a sale price value that is discounted very low compared
            to the price.
        SALES_PRICE_TOO_HIGH:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a sale price value that is higher than the original
            price of the item.
        SALE_DATE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a sale_price_effective_date value that is formatted
            incorrectly, this item will be published without a sale date.
        SHIPPING_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a shipping value that is formatted incorrectly.
        SHIPPING_HEIGHT_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an incorrectly formatted shipping_height value. The
            value must first contain a numeric value then a valid dimension unit type.
        SHIPPING_WEIGHT_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an invalid shipping_weight value.
        SHIPPING_WIDTH_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an incorrectly formatted shipping_width value. The
            value must first contain a numeric value then a valid dimension unit type.
        SIZE_TYPE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a size type value that is formatted incorrectly, which
            may limit visibility in recommendations, search results and shopping experiences.
        TAX_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a tax value that is formatted incorrectly.
        TITLE_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: The title for the item was truncated because it contains too
            many characters.
        TOO_MANY_ADDITIONAL_IMAGE_LINKS:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a additional_image_link value that exceed the limit
            for additional images, this item will be published without some of your
            images.
        UTM_SOURCE_AUTO_CORRECTED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes an utm_source value that is formatted incorrectly
            and has been automatically corrected.
        WEIGHT_UNIT_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a weight_unit value that is formatted incorrectly,
            this item will be published without a weight unit.
    CatalogsItems:
      type: object
      description: Response object of catalogs items
      properties:
        items:
          type: array
          description: Array with catalogs items
          items:
            $ref: '#/components/schemas/ItemResponse'
    CatalogsItemsBatch:
      type: object
      description: Object describing the catalogs items batch
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
      required:
      - catalog_type
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailItemsBatch'
      - $ref: '#/components/schemas/CatalogsHotelItemsBatch'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsItemsBatch'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailItemsBatch'
          HOTEL: '#/components/schemas/CatalogsHotelItemsBatch'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsItemsBatch'
    CatalogsItemsFilters:
      type: object
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
      required:
      - catalog_type
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailItemsFilter'
      - $ref: '#/components/schemas/CatalogsHotelItemsFilter'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsItemsFilter'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailItemsFilter'
          HOTEL: '#/components/schemas/CatalogsHotelItemsFilter'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsItemsFilter'
    CatalogsItemsPostFilters:
      type: object
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
      required:
      - catalog_type
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailItemsPostFilter'
      - $ref: '#/components/schemas/CatalogsHotelItemsPostFilter'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsItemsPostFilter'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailItemsPostFilter'
          HOTEL: '#/components/schemas/CatalogsHotelItemsPostFilter'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsItemsPostFilter'
    CatalogsCreativeAssetsItemsBatch:
      type: object
      description: Object describing the catalogs creative assets items batch
      properties:
        batch_id:
          description: Id of the catalogs items batch
          example: 595953100599279259-66753b9bb65c46c49bd8503b27fecf9e
          type: string
        created_time:
          description: 'Date and time (UTC) of the batch creation: YYYY-MM-DD''T''hh:mm:ss'
          example: '2024-01-01T20:10:40'
          type: string
          format: date-time
          readOnly: true
        completed_time:
          description: 'Date and time (UTC) of the batch completion: YYYY-MM-DD''T''hh:mm:ss'
          example: '2024-01-01T20:20:00'
          type: string
          format: date-time
          readOnly: true
          nullable: true
        status:
          $ref: '#/components/schemas/BatchOperationStatus'
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        items:
          description: Array with the catalogs items processing records part of the
            catalogs items batch
          items:
            $ref: '#/components/schemas/CreativeAssetsProcessingRecord'
          type: array
      required:
      - catalog_type
    CatalogsHotelItemsBatch:
      type: object
      description: Object describing the catalogs hotel items batch
      properties:
        batch_id:
          description: Id of the catalogs items batch
          example: 595953100599279259-66753b9bb65c46c49bd8503b27fecf9e
          type: string
        created_time:
          description: 'Date and time (UTC) of the batch creation: YYYY-MM-DD''T''hh:mm:ss'
          example: '2024-01-01T20:10:40'
          type: string
          format: date-time
          readOnly: true
        completed_time:
          description: 'Date and time (UTC) of the batch completion: YYYY-MM-DD''T''hh:mm:ss'
          example: '2024-01-01T20:20:00'
          type: string
          format: date-time
          readOnly: true
          nullable: true
        status:
          $ref: '#/components/schemas/BatchOperationStatus'
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        items:
          description: Array with the catalogs items processing records part of the
            catalogs items batch
          items:
            $ref: '#/components/schemas/HotelProcessingRecord'
          type: array
      required:
      - catalog_type
    CatalogsRetailItemsBatch:
      type: object
      description: Object describing the catalogs retail items batch
      properties:
        batch_id:
          description: Id of the catalogs items batch
          example: 595953100599279259-66753b9bb65c46c49bd8503b27fecf9e
          type: string
        created_time:
          description: 'Date and time (UTC) of the batch creation: YYYY-MM-DD''T''hh:mm:ss'
          example: '2024-01-01T20:10:40'
          type: string
          format: date-time
          readOnly: true
        completed_time:
          description: 'Date and time (UTC) of the batch completion: YYYY-MM-DD''T''hh:mm:ss'
          example: '2024-01-01T20:20:00'
          type: string
          format: date-time
          readOnly: true
          nullable: true
        status:
          $ref: '#/components/schemas/BatchOperationStatus'
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        items:
          description: Array with the catalogs items processing records part of the
            catalogs items batch
          items:
            $ref: '#/components/schemas/ItemProcessingRecord'
          type: array
      required:
      - catalog_type
    CatalogsItemsRequest:
      type: object
      additionalProperties: false
      description: Request object of catalogs items
      properties:
        country:
          $ref: '#/components/schemas/Country'
        language:
          description: We recommend using the CatalogsLocale values.
          anyOf:
          - $ref: '#/components/schemas/CatalogsLocale'
          - $ref: '#/components/schemas/Language'
        filters:
          $ref: '#/components/schemas/CatalogsItemsPostFilters'
      required:
      - country
      - language
      - filters
    CatalogsItemsBatchRequest:
      type: object
      title: legacy_retail_only
      description: Request object of catalogs items batch
      oneOf:
      - $ref: '#/components/schemas/CatalogsItemsUpdateBatchRequest'
      - $ref: '#/components/schemas/CatalogsItemsUpsertBatchRequest'
      - $ref: '#/components/schemas/CatalogsItemsCreateBatchRequest'
      - $ref: '#/components/schemas/CatalogsItemsDeleteDiscontinuedBatchRequest'
      - $ref: '#/components/schemas/CatalogsItemsDeleteBatchRequest'
      discriminator:
        propertyName: operation
        mapping:
          UPDATE: '#/components/schemas/CatalogsItemsUpdateBatchRequest'
          UPSERT: '#/components/schemas/CatalogsItemsUpsertBatchRequest'
          CREATE: '#/components/schemas/CatalogsItemsCreateBatchRequest'
          DELETE_DISCONTINUED: '#/components/schemas/CatalogsItemsDeleteDiscontinuedBatchRequest'
          DELETE: '#/components/schemas/CatalogsItemsDeleteBatchRequest'
    CatalogsItemsCreateBatchRequest:
      description: Request object to create catalogs items
      type: object
      additionalProperties: false
      properties:
        country:
          $ref: '#/components/schemas/Country'
        language:
          description: We recommend using the CatalogsLocale values.
          anyOf:
          - $ref: '#/components/schemas/CatalogsLocale'
          - $ref: '#/components/schemas/Language'
        operation:
          $ref: '#/components/schemas/BatchOperation'
        items:
          type: array
          description: Array with catalogs items
          items:
            $ref: '#/components/schemas/ItemCreateBatchRecord'
          minItems: 1
          maxItems: 1000
      required:
      - country
      - language
      - operation
      - items
    CatalogsItemsDeleteBatchRequest:
      description: Request object to delete catalogs items
      type: object
      additionalProperties: false
      properties:
        country:
          $ref: '#/components/schemas/Country'
        language:
          description: We recommend using the CatalogsLocale values.
          anyOf:
          - $ref: '#/components/schemas/CatalogsLocale'
          - $ref: '#/components/schemas/Language'
        operation:
          $ref: '#/components/schemas/BatchOperation'
        items:
          type: array
          description: Array with catalogs items
          items:
            $ref: '#/components/schemas/ItemDeleteBatchRecord'
      required:
      - country
      - language
      - operation
      - items
    CatalogsItemsDeleteDiscontinuedBatchRequest:
      description: Request object to discontinue catalogs items
      type: object
      additionalProperties: false
      properties:
        country:
          $ref: '#/components/schemas/Country'
        language:
          description: We recommend using the CatalogsLocale values.
          anyOf:
          - $ref: '#/components/schemas/CatalogsLocale'
          - $ref: '#/components/schemas/Language'
        operation:
          $ref: '#/components/schemas/BatchOperation'
        items:
          type: array
          description: Array with catalogs items
          items:
            $ref: '#/components/schemas/ItemDeleteDiscontinuedBatchRecord'
      required:
      - country
      - language
      - operation
      - items
    CatalogsItemsUpdateBatchRequest:
      description: Request object to update catalogs items
      type: object
      additionalProperties: false
      properties:
        country:
          $ref: '#/components/schemas/Country'
        language:
          description: We recommend using the CatalogsLocale values.
          anyOf:
          - $ref: '#/components/schemas/CatalogsLocale'
          - $ref: '#/components/schemas/Language'
        operation:
          $ref: '#/components/schemas/BatchOperation'
        items:
          type: array
          description: Array with catalogs items
          items:
            $ref: '#/components/schemas/ItemUpdateBatchRecord'
          minItems: 1
          maxItems: 1000
      required:
      - country
      - language
      - operation
      - items
    CatalogsItemsUpsertBatchRequest:
      description: Request object to upsert catalogs items
      type: object
      properties:
        country:
          $ref: '#/components/schemas/Country'
        language:
          description: We recommend using the CatalogsLocale values.
          anyOf:
          - $ref: '#/components/schemas/CatalogsLocale'
          - $ref: '#/components/schemas/Language'
        operation:
          $ref: '#/components/schemas/BatchOperation'
        items:
          type: array
          description: Array with catalogs items
          items:
            $ref: '#/components/schemas/ItemUpsertBatchRecord'
          minItems: 1
          maxItems: 1000
      required:
      - country
      - language
      - operation
      - items
    CatalogsListProductsByFilterRequest:
      description: Request object to list products for a given product group filter.
      type: object
      oneOf:
      - $ref: '#/components/schemas/CatalogsListProductsByFeedBasedFilter'
      - $ref: '#/components/schemas/CatalogsVerticalsListProductsByCatalogBasedFilterRequest'
    CatalogsListProductsByFeedBasedFilter:
      title: feed based product group
      description: Request object to list products for a given feed_id and product
        group filter.
      type: object
      additionalProperties: false
      properties:
        feed_id:
          description: Catalog Feed id pertaining to the catalog product group filter.
          example: '2680059592705'
          type: string
          pattern: ^\d+$
        filters:
          $ref: '#/components/schemas/CatalogsProductGroupFilters'
      required:
      - feed_id
      - filters
    CatalogsVerticalsListProductsByCatalogBasedFilterRequest:
      type: object
      title: catalog based product group
      description: Request object to list products for a given catalog_id and product
        group filter.
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailListProductsByCatalogBasedFilterRequest'
      - $ref: '#/components/schemas/CatalogsHotelListProductsByCatalogBasedFilterRequest'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsListProductsByCatalogBasedFilterRequest'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailListProductsByCatalogBasedFilterRequest'
          HOTEL: '#/components/schemas/CatalogsHotelListProductsByCatalogBasedFilterRequest'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsListProductsByCatalogBasedFilterRequest'
    CatalogsRetailListProductsByCatalogBasedFilterRequest:
      type: object
      title: retail_list_products_by_catalog_based_filter_request
      additionalProperties: false
      description: Request object to list products for a given retail catalog_id and
        product group filter.
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
          description: Retail catalog based product group is available only for selected
            partners at the moment. If you are not eligible, please use feed based
            one.
        catalog_id:
          description: Catalog id pertaining to the retail product group.
          example: '2680059592705'
          type: string
          pattern: ^\d+$
        filters:
          $ref: '#/components/schemas/CatalogsProductGroupFilters'
        country:
          $ref: '#/components/schemas/Country'
        locale:
          $ref: '#/components/schemas/CatalogsLocale'
      required:
      - catalog_type
      - catalog_id
      - filters
      - country
      - locale
    CatalogsHotelListProductsByCatalogBasedFilterRequest:
      type: object
      title: hotel_list_products_by_catalog_based_filter_request
      additionalProperties: false
      description: Request object to list products for a given hotel catalog_id and
        product group filter.
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        catalog_id:
          description: Catalog id pertaining to the hotel product group.
          example: '2680059592705'
          type: string
          pattern: ^\d+$
        filters:
          $ref: '#/components/schemas/CatalogsHotelProductGroupFilters'
      required:
      - catalog_type
      - catalog_id
      - filters
    CatalogsCreativeAssetsListProductsByCatalogBasedFilterRequest:
      type: object
      title: creative_assets_list_products_by_catalog_based_filter_request
      additionalProperties: false
      description: Request object to list products for a given creative assets catalog_id
        and product group filter.
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        catalog_id:
          description: Catalog id pertaining to the creative assets product group.
          example: '2680059592705'
          type: string
          pattern: ^\d+$
        filters:
          $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupFilters'
      required:
      - catalog_type
      - catalog_id
      - filters
    CatalogsLocale:
      type: string
      enum:
      - 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
    CatalogsProduct:
      type: object
      description: Catalogs product for all verticals
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
      required:
      - catalog_type
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailProduct'
      - $ref: '#/components/schemas/CatalogsHotelProduct'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsProduct'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailProduct'
          HOTEL: '#/components/schemas/CatalogsHotelProduct'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsProduct'
    CatalogsVerticalProductGroup:
      type: object
      title: product_group
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailProductGroup'
      - $ref: '#/components/schemas/CatalogsHotelProductGroup'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroup'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailProductGroup'
          HOTEL: '#/components/schemas/CatalogsHotelProductGroup'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsProductGroup'
    CatalogsCreativeAssetsProductGroup:
      type: object
      title: creative_assets_product_group
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        id:
          description: ID of the creative assets product group.
          example: '443727193917'
          type: string
          pattern: ^\d+$
        name:
          description: Name of creative assets product group
          example: Most Popular
          type: string
        description:
          type: string
          nullable: true
        filters:
          $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupFilters'
        created_at:
          description: Unix timestamp in seconds of when catalog product group was
            created.
          example: 1621350033000
          type: integer
        updated_at:
          description: Unix timestamp in seconds of last time catalog product group
            was updated.
          example: 1622742155000
          type: integer
        catalog_id:
          description: Catalog id pertaining to the creative assets product group.
          type: string
          pattern: ^\d+$
      required:
      - id
      - filters
      - catalog_type
      - catalog_id
    CatalogsCreativeAssetsProductGroupFilters:
      description: Object holding a group of filters for a creative assets product
        group
      title: catalogs_product_group_filters
      type: object
      anyOf:
      - $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAnyOf'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupFiltersAllOf'
    CatalogsCreativeAssetsProductGroupFiltersAllOf:
      type: object
      title: all_of
      additionalProperties: false
      properties:
        all_of:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupFilterKeys'
      required:
      - all_of
    CatalogsCreativeAssetsProductGroupFiltersAnyOf:
      type: object
      title: any_of
      additionalProperties: false
      properties:
        any_of:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupFilterKeys'
      required:
      - any_of
    CatalogsCreativeAssetsProductGroupFilterKeys:
      title: catalogs_product_group_keys
      anyOf:
      - $ref: '#/components/schemas/CreativeAssetsIdFilter'
      - $ref: '#/components/schemas/CustomLabel0Filter'
      - $ref: '#/components/schemas/CustomLabel1Filter'
      - $ref: '#/components/schemas/CustomLabel2Filter'
      - $ref: '#/components/schemas/CustomLabel3Filter'
      - $ref: '#/components/schemas/CustomLabel4Filter'
      - $ref: '#/components/schemas/GoogleProductCategory6Filter'
      - $ref: '#/components/schemas/GoogleProductCategory5Filter'
      - $ref: '#/components/schemas/GoogleProductCategory4Filter'
      - $ref: '#/components/schemas/GoogleProductCategory3Filter'
      - $ref: '#/components/schemas/GoogleProductCategory2Filter'
      - $ref: '#/components/schemas/GoogleProductCategory1Filter'
      - $ref: '#/components/schemas/GoogleProductCategory0Filter'
      - $ref: '#/components/schemas/MediaTypeFilter'
      - $ref: '#/components/schemas/TitleKeywordsFilter'
    CatalogsCreativeAssetsProductGroupCreateRequest:
      type: object
      title: creative_assets_product_groups_create_request
      additionalProperties: false
      description: Request object for creating a creative assets product group.
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        name:
          type: string
        description:
          type: string
          nullable: true
        filters:
          $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupFilters'
        catalog_id:
          description: Catalog id pertaining to the creative assets product group.
          example: '2680059592705'
          type: string
          pattern: ^\d+$
      required:
      - name
      - filters
      - catalog_id
      - catalog_type
    CatalogsCreativeAssetsProductGroupUpdateRequest:
      type: object
      title: creative_assets_product_groups_update_request
      additionalProperties: false
      description: Request object for updating a creative assets product group.
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        name:
          type: string
        description:
          type: string
          nullable: true
        filters:
          $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupFilters'
    CatalogsHotelProductGroup:
      type: object
      title: hotel_product_group
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        id:
          description: ID of the hotel product group.
          example: '443727193917'
          type: string
          pattern: ^\d+$
        name:
          description: Name of hotel product group
          example: Most Popular
          type: string
        description:
          type: string
          nullable: true
        filters:
          $ref: '#/components/schemas/CatalogsHotelProductGroupFilters'
        type:
          $ref: '#/components/schemas/CatalogsHotelProductGroupType'
        created_at:
          description: Unix timestamp in seconds of when catalog product group was
            created.
          example: 1621350033000
          type: integer
        updated_at:
          description: Unix timestamp in seconds of last time catalog product group
            was updated.
          example: 1622742155000
          type: integer
        catalog_id:
          description: Catalog id pertaining to the hotel product group.
          type: string
          pattern: ^\d+$
      required:
      - id
      - filters
      - catalog_type
      - catalog_id
      - type
    CatalogsHotelProductGroupFilterKeys:
      title: catalogs_product_group_keys
      anyOf:
      - $ref: '#/components/schemas/PriceFilter'
      - $ref: '#/components/schemas/HotelIdFilter'
      - $ref: '#/components/schemas/BrandFilter'
      - $ref: '#/components/schemas/CustomLabel0Filter'
      - $ref: '#/components/schemas/CustomLabel1Filter'
      - $ref: '#/components/schemas/CustomLabel2Filter'
      - $ref: '#/components/schemas/CustomLabel3Filter'
      - $ref: '#/components/schemas/CustomLabel4Filter'
      - $ref: '#/components/schemas/CountryFilter'
      - $ref: '#/components/schemas/TitleKeywordsFilter'
    CatalogsHotelProductGroupFilters:
      description: Object holding a group of filters for a hotel product group
      title: catalogs_product_group_filters
      type: object
      anyOf:
      - $ref: '#/components/schemas/CatalogsHotelProductGroupFiltersAnyOf'
      - $ref: '#/components/schemas/CatalogsHotelProductGroupFiltersAllOf'
    CatalogsHotelProductGroupFiltersAllOf:
      type: object
      title: all_of
      additionalProperties: false
      properties:
        all_of:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/CatalogsHotelProductGroupFilterKeys'
      required:
      - all_of
    CatalogsHotelProductGroupFiltersAnyOf:
      type: object
      title: any_of
      additionalProperties: false
      properties:
        any_of:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/CatalogsHotelProductGroupFilterKeys'
      required:
      - any_of
    CatalogsRetailProductGroup:
      type: object
      title: retail_product_group
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
        id:
          description: ID of the catalog product group.
          example: '443727193917'
          type: string
          pattern: ^\d+$
        name:
          description: Name of catalog product group
          example: Most Popular
          type: string
        description:
          type: string
          nullable: true
        filters:
          $ref: '#/components/schemas/CatalogsProductGroupFilters'
        is_featured:
          deprecated: true
          description: boolean indicator of whether the product group is being featured
            or not
          type: boolean
        type:
          $ref: '#/components/schemas/CatalogsProductGroupType'
        status:
          $ref: '#/components/schemas/CatalogsProductGroupStatus'
        created_at:
          description: Unix timestamp in seconds of when catalog product group was
            created.
          example: 1621350033000
          type: integer
        updated_at:
          description: Unix timestamp in seconds of last time catalog product group
            was updated.
          example: 1622742155000
          type: integer
        catalog_id:
          description: Catalog id pertaining to the retail product group.
          type: string
          pattern: ^\d+$
        feed_id:
          description: id of the catalogs feed belonging to this catalog product group
          example: '2680059592705'
          type: string
          pattern: ^\d+$
          nullable: true
        country:
          type: string
          nullable: true
        locale:
          type: string
          nullable: true
      required:
      - filters
      - id
      - catalog_id
      - feed_id
      - catalog_type
      - type
    CatalogsHotelProductGroupCreateRequest:
      type: object
      title: hotel_product_groups_create_request
      additionalProperties: false
      description: Request object for creating a hotel product group.
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        name:
          type: string
        description:
          type: string
          nullable: true
        filters:
          $ref: '#/components/schemas/CatalogsHotelProductGroupFilters'
        catalog_id:
          description: Catalog id pertaining to the hotel product group.
          example: '2680059592705'
          type: string
          pattern: ^\d+$
      required:
      - name
      - filters
      - catalog_id
      - catalog_type
    CatalogsRetailProductGroupCreateRequest:
      type: object
      title: retail_product_groups_create_request
      additionalProperties: false
      description: Request object for creating a product group.
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
          description: Retail catalog based product group is available only for selected
            partners at the moment. If you are not eligible, please use feed based
            one.
        name:
          type: string
        description:
          type: string
          nullable: true
        filters:
          $ref: '#/components/schemas/CatalogsProductGroupFiltersRequest'
        catalog_id:
          description: Catalog id pertaining to the retail product group.
          example: '2680059592705'
          type: string
          pattern: ^\d+$
        country:
          $ref: '#/components/schemas/Country'
        locale:
          $ref: '#/components/schemas/CatalogsLocale'
      required:
      - name
      - filters
      - catalog_id
      - catalog_type
    CatalogsHotelProductGroupUpdateRequest:
      type: object
      title: hotel_product_groups_update_request
      additionalProperties: false
      description: Request object for updating a hotel product group.
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        name:
          type: string
        description:
          type: string
          nullable: true
        filters:
          $ref: '#/components/schemas/CatalogsHotelProductGroupFilters'
    CatalogsRetailProductGroupUpdateRequest:
      type: object
      title: retail_product_groups_update_request
      additionalProperties: false
      description: Request object for updating a retail product group.
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
          description: Retail catalog based product group is available only for selected
            partners at the moment. If you are not eligible, please use feed based
            one.
        name:
          type: string
        description:
          type: string
          nullable: true
        filters:
          $ref: '#/components/schemas/CatalogsProductGroupFiltersRequest'
        country:
          $ref: '#/components/schemas/Country'
        locale:
          $ref: '#/components/schemas/CatalogsLocale'
    CatalogsProductGroupCreateRequest:
      type: object
      title: retail feed based
      description: Request object for creating a product group.
      properties:
        name:
          type: string
        description:
          type: string
          nullable: true
        is_featured:
          deprecated: true
          description: boolean indicator of whether the product group is being featured
            or not
          type: boolean
          default: false
        filters:
          $ref: '#/components/schemas/CatalogsProductGroupFiltersRequest'
        feed_id:
          description: Catalog Feed id pertaining to the catalog product group.
          example: '2680059592705'
          type: string
          pattern: ^\d+$
      required:
      - name
      - filters
      - feed_id
    CatalogsProductGroupCurrencyCriteria:
      title: catalogs_product_group_currency_criteria
      type: object
      description: A currency filter. This filter cannot be negated
      additionalProperties: false
      properties:
        values:
          $ref: '#/components/schemas/NonNullableCatalogsCurrency'
        negated:
          type: boolean
          default: false
          enum:
          - false
      required:
      - values
    CatalogsProductGroupFilterKeys:
      title: catalogs_product_group_keys
      anyOf:
      - $ref: '#/components/schemas/MinPriceFilter'
      - $ref: '#/components/schemas/MaxPriceFilter'
      - $ref: '#/components/schemas/CurrencyFilter'
      - $ref: '#/components/schemas/ItemIdFilter'
      - $ref: '#/components/schemas/AvailabilityFilter'
      - $ref: '#/components/schemas/BrandFilter'
      - $ref: '#/components/schemas/ConditionFilter'
      - $ref: '#/components/schemas/CustomLabel0Filter'
      - $ref: '#/components/schemas/CustomLabel1Filter'
      - $ref: '#/components/schemas/CustomLabel2Filter'
      - $ref: '#/components/schemas/CustomLabel3Filter'
      - $ref: '#/components/schemas/CustomLabel4Filter'
      - $ref: '#/components/schemas/ItemGroupIdFilter'
      - $ref: '#/components/schemas/GenderFilter'
      - $ref: '#/components/schemas/MediaTypeFilter'
      - $ref: '#/components/schemas/ProductType4Filter'
      - $ref: '#/components/schemas/ProductType3Filter'
      - $ref: '#/components/schemas/ProductType2Filter'
      - $ref: '#/components/schemas/ProductType1Filter'
      - $ref: '#/components/schemas/ProductType0Filter'
      - $ref: '#/components/schemas/GoogleProductCategory6Filter'
      - $ref: '#/components/schemas/GoogleProductCategory5Filter'
      - $ref: '#/components/schemas/GoogleProductCategory4Filter'
      - $ref: '#/components/schemas/GoogleProductCategory3Filter'
      - $ref: '#/components/schemas/GoogleProductCategory2Filter'
      - $ref: '#/components/schemas/GoogleProductCategory1Filter'
      - $ref: '#/components/schemas/GoogleProductCategory0Filter'
      - $ref: '#/components/schemas/ProductGroupReferenceFilter'
      - $ref: '#/components/schemas/CustomNumber0Filter'
      - $ref: '#/components/schemas/CustomNumber1Filter'
      - $ref: '#/components/schemas/CustomNumber2Filter'
      - $ref: '#/components/schemas/CustomNumber3Filter'
      - $ref: '#/components/schemas/CustomNumber4Filter'
      - $ref: '#/components/schemas/TitleKeywordsFilter'
    CatalogsProductGroupFilters:
      description: Object holding a group of filters for a catalog product group
      title: catalogs_product_group_filters
      type: object
      anyOf:
      - $ref: '#/components/schemas/CatalogsProductGroupFiltersAnyOf'
      - $ref: '#/components/schemas/CatalogsProductGroupFiltersAllOf'
    CatalogsProductGroupFiltersAllOf:
      type: object
      title: all_of
      additionalProperties: false
      properties:
        all_of:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/CatalogsProductGroupFilterKeys'
      required:
      - all_of
    CatalogsProductGroupFiltersRequest:
      description: Object holding a group of filters for request on catalog product
        group. This is a distinct schema It is not possible to create or update a
        Product Group with empty filters. But some automatically generated Product
        Groups might have empty filters.
      title: catalogs_product_group_filters
      type: object
      anyOf:
      - type: object
        title: any_of
        additionalProperties: false
        properties:
          any_of:
            type: array
            items:
              type: object
              $ref: '#/components/schemas/CatalogsProductGroupFilterKeys'
            minItems: 1
        required:
        - any_of
      - type: object
        title: all_of
        additionalProperties: false
        properties:
          all_of:
            type: array
            items:
              type: object
              $ref: '#/components/schemas/CatalogsProductGroupFilterKeys'
            minItems: 1
        required:
        - all_of
    CatalogsProductGroupFiltersAnyOf:
      type: object
      title: any_of
      additionalProperties: false
      properties:
        any_of:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/CatalogsProductGroupFilterKeys'
      required:
      - any_of
    CatalogsProductGroupMultipleCountriesCriteria:
      title: catalogs_product_group_multiple_country_criteria
      type: object
      additionalProperties: false
      properties:
        values:
          type: array
          items:
            $ref: '#/components/schemas/Country'
        negated:
          type: boolean
          default: false
      required:
      - values
    CatalogsProductGroupMultipleGenderCriteria:
      title: catalogs_product_group_multiple_gender_criteria
      type: object
      additionalProperties: false
      properties:
        values:
          type: array
          items:
            $ref: '#/components/schemas/Gender'
        negated:
          type: boolean
          default: false
      required:
      - values
    CatalogsProductGroupMultipleMediaTypesCriteria:
      title: catalogs_product_group_multiple_media_type_criteria
      type: object
      additionalProperties: false
      properties:
        values:
          type: array
          items:
            $ref: '#/components/schemas/MediaType'
        negated:
          type: boolean
          default: false
      required:
      - values
    CatalogsProductGroupMultipleStringCriteria:
      title: catalogs_product_group_multiple_string_criteria
      type: object
      additionalProperties: false
      properties:
        values:
          type: array
          items:
            type: string
        negated:
          type: boolean
          default: false
      required:
      - values
    CatalogsProductGroupFilterOperatorTypeCriteria:
      title: catalogs_product_group_filter_operator_type_criteria
      type: object
      additionalProperties: false
      properties:
        values:
          type: array
          items:
            type: string
        negated:
          type: boolean
          default: false
        filter_operator_type:
          default: IS
          type: string
          enum:
          - IS
          - CONTAINS
      required:
      - values
    CatalogsProductGroupMultipleStringListCriteria:
      title: catalogs_product_group_multiple_string_list_criteria
      type: object
      additionalProperties: false
      properties:
        values:
          type: array
          items:
            type: array
            items:
              type: string
        negated:
          type: boolean
          default: false
      required:
      - values
    CatalogsProductGroupPricingCriteria:
      title: catalogs_product_group_pricing_criteria
      type: object
      additionalProperties: false
      properties:
        inclusion:
          type: boolean
          default: true
        values:
          type: number
          minimum: 0
        negated:
          type: boolean
          default: false
      required:
      - values
    CatalogsProductGroupUint32Criteria:
      title: catalogs_product_group_uint32_criteria
      type: object
      additionalProperties: false
      properties:
        operator:
          type: string
          enum:
          - GREATER_THAN
          - GREATER_THAN_OR_EQUALS
          - LESS_THAN
          - LESS_THAN_OR_EQUALS
        value:
          type: integer
          minimum: 0
          maximum: 4294967295
        negated:
          type: boolean
          default: false
      required:
      - operator
      - value
    CatalogsProductGroupProductCountsVertical:
      type: object
      description: Product counts for a CatalogsProductGroup
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
      required:
      - catalog_type
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailProductGroupProductCounts'
      - $ref: '#/components/schemas/CatalogsHotelProductGroupProductCounts'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupProductCounts'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailProductGroupProductCounts'
          HOTEL: '#/components/schemas/CatalogsHotelProductGroupProductCounts'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsProductGroupProductCounts'
    CatalogsHotelProductGroupProductCounts:
      title: catalogs_hotel_product_group_product_counts
      description: Product counts for a Hotel CatalogsProductGroup
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        total:
          type: number
          minimum: 0
      required:
      - catalog_type
      - total
    CatalogsCreativeAssetsProductGroupProductCounts:
      title: catalogs_creative_assets_product_group_product_counts
      description: Product counts for a Creative Assets CatalogsProductGroup
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        total:
          type: number
          minimum: 0
        videos:
          type: number
          minimum: 0
      required:
      - catalog_type
      - total
      - videos
    CatalogsRetailProductGroupProductCounts:
      title: catalogs_retail_product_group_product_counts
      description: Product counts for a Retail CatalogsProductGroup
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
        in_stock:
          type: number
          minimum: 0
        out_of_stock:
          type: number
          minimum: 0
        preorder:
          type: number
          minimum: 0
        total:
          type: number
          minimum: 0
        videos:
          type: number
          minimum: 0
      required:
      - catalog_type
      - in_stock
      - out_of_stock
      - preorder
      - total
    CatalogsProductGroupStatus:
      type: string
      enum:
      - ACTIVE
      - INACTIVE
    CatalogsProductGroupType:
      type: string
      title: product_group_type
      description: |-
        <p>Catalog product group type</p>
        <p>MERCHANT_CREATED: Product groups created by merchants.
        <br>ALL_PRODUCTS: Consists of every product in your latest successful feed upload.
        <br>BEST_DEALS: Consists of products with the deepest drop in price.
        <br>PINNER_FAVORITES: Consists of products that are resonating most with people on Pinterest, based on engagement.
        <br>TOP_SELLERS: Consists of products with the highest conversion rate, if you have the conversion tag installed.
        <br>BACK_IN_STOCK: Consists of products that were previously out of stock and are now in stock.
        <br>NEW_ARRIVALS: Consists of products that are new to your Catalog.
        <br>SHOPIFY_COLLECTION: Product groups created based on Shopify Product Collections.
        <br>I2PC: Product groups created based on predicted product category.</p>
      enum:
      - MERCHANT_CREATED
      - ALL_PRODUCTS
      - BEST_DEALS
      - PINNER_FAVORITES
      - TOP_SELLERS
      - BACK_IN_STOCK
      - NEW_ARRIVALS
      - SHOPIFY_COLLECTIONS
      - I2PC
      example: TOP_SELLERS
    CatalogsHotelProductGroupType:
      type: string
      title: hotel_product_group_type
      description: |-
        <p>Catalog hotel product group type</p>
        <p>MERCHANT_CREATED: Product groups created by merchants.
        <br>ALL_LISTINGS: Includes every hotel item in your catalog.
      enum:
      - MERCHANT_CREATED
      - ALL_LISTINGS
      example: MERCHANT_CREATED
    CatalogsProductGroupUpdateRequest:
      type: object
      title: retail feed based
      additionalProperties: false
      description: Request object for updating a product group.
      properties:
        name:
          type: string
        description:
          type: string
          nullable: true
        is_featured:
          deprecated: true
          description: boolean indicator of whether the product group is being featured
            or not
          type: boolean
        filters:
          $ref: '#/components/schemas/CatalogsProductGroupFiltersRequest'
    CatalogsRetailProduct:
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
        metadata:
          $ref: '#/components/schemas/CatalogsRetailProductMetadata'
        pin:
          $ref: '#/components/schemas/Pin'
      required:
      - catalog_type
      - metadata
      - pin
    CatalogsRetailProductMetadata:
      type: object
      description: Retail product metadata entity
      properties:
        item_id:
          description: The user-created unique ID that represents the product.
          example: DS0294-L
          type: string
        item_group_id:
          description: The parent ID of the product.
          example: DS0294
          type: string
          nullable: true
        availability:
          $ref: '#/components/schemas/NonNullableProductAvailabilityType'
        price:
          description: The price of the product.
          example: 24.99
          type: number
        sale_price:
          description: The discounted price of the product.
          example: 14.99
          type: number
          nullable: true
        currency:
          $ref: '#/components/schemas/NonNullableCatalogsCurrency'
      required:
      - item_id
      - item_group_id
      - availability
      - price
      - sale_price
      - currency
    CatalogsStatus:
      type: string
      description: Status for catalogs entities. Present in catalogs_feed values.
        When a feed is deleted, the response will inform DELETED as status.
      enum:
      - ACTIVE
      - INACTIVE
    CatalogsType:
      description: Type of the catalog entity.
      type: string
      enum:
      - RETAIL
      - HOTEL
      - CREATIVE_ASSETS
    CatalogsVerticalBatchRequest:
      type: object
      title: operate on item batch
      description: A request object that can have multiple operations on a single
        batch
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailBatchRequest'
      - $ref: '#/components/schemas/CatalogsHotelBatchRequest'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsBatchRequest'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailBatchRequest'
          HOTEL: '#/components/schemas/CatalogsHotelBatchRequest'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsBatchRequest'
    CatalogsHotelGuestRatings:
      type: object
      description: If specified, you must provide all properties
      properties:
        score:
          description: Your hotel's rating.
          type: number
        number_of_reviewers:
          description: Total number of people who have rated this hotel.
          type: integer
        max_score:
          description: Max value for the hotel rating score.
          type: number
        rating_system:
          description: System you use for guest reviews.
          type: string
    CatalogsHotelItemErrorResponse:
      type: object
      description: Object describing a hotel item error
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        hotel_id:
          description: The catalog hotel id in the merchant namespace
          example: DS0294-M
          type: string
        errors:
          description: Array with the errors for the item id requested
          items:
            $ref: '#/components/schemas/ItemValidationEvent'
          type: array
      required:
      - catalog_type
    CatalogsHotelItemResponse:
      type: object
      description: Object describing a hotel record
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        hotel_id:
          description: The catalog hotel id in the merchant namespace
          example: DS0294-M
          type: string
        pins:
          description: The pins mapped to the item
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/Pin'
          maxItems: 11
        attributes:
          $ref: '#/components/schemas/CatalogsHotelAttributes'
      required:
      - catalog_type
    CatalogsCreativeAssetsItemErrorResponse:
      type: object
      description: Object describing a creative assets item error
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        creative_assets_id:
          description: The catalog creative assets id in the merchant namespace
          example: DS0294-M
          type: string
        errors:
          description: Array with the errors for the item id requested
          items:
            $ref: '#/components/schemas/ItemValidationEvent'
          type: array
      required:
      - catalog_type
    CatalogsCreativeAssetsItemResponse:
      type: object
      description: Object describing a hotel record
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        creative_assets_id:
          description: The catalog creative assets id in the merchant namespace
          example: DS0294-M
          type: string
        pins:
          description: The pins mapped to the item
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/Pin'
          maxItems: 11
        attributes:
          $ref: '#/components/schemas/CatalogsCreativeAssetsAttributes'
      required:
      - catalog_type
    CreativeAssetsProcessingRecord:
      type: object
      description: Object describing an item processing record
      properties:
        creative_assets_id:
          description: The catalog creative assets id in the merchant namespace
          example: DS0294-M
          type: string
        errors:
          description: |-
            Array with the validation errors for the item processing record.
            A non empty errors list causes the item processing to fail.
          items:
            $ref: '#/components/schemas/ItemValidationEvent'
          type: array
        warnings:
          description: Array with the validation warnings for the item processing
            record
          items:
            $ref: '#/components/schemas/ItemValidationEvent'
          type: array
        status:
          $ref: '#/components/schemas/ItemProcessingStatus'
    CatalogsRetailBatchRequest:
      type: object
      description: A request object that can have multiple operations on a single
        retail batch
      additionalProperties: false
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
        country:
          $ref: '#/components/schemas/Country'
        language:
          description: We recommend using the CatalogsLocale values.
          anyOf:
          - $ref: '#/components/schemas/CatalogsLocale'
          - $ref: '#/components/schemas/Language'
        items:
          minItems: 1
          maxItems: 1000
          type: array
          description: Array with catalogs item operations
          items:
            anyOf:
            - $ref: '#/components/schemas/CatalogsCreateRetailItem'
            - $ref: '#/components/schemas/CatalogsUpdateRetailItem'
            - $ref: '#/components/schemas/CatalogsUpsertRetailItem'
            - $ref: '#/components/schemas/CatalogsDeleteRetailItem'
            discriminator:
              propertyName: operation
              mapping:
                CREATE: '#/components/schemas/CatalogsCreateRetailItem'
                UPDATE: '#/components/schemas/CatalogsUpdateRetailItem'
                UPSERT: '#/components/schemas/CatalogsUpsertRetailItem'
                DELETE: '#/components/schemas/CatalogsDeleteRetailItem'
        catalog_id:
          description: Catalog id pertaining to the retail item. If not provided,
            default to oldest retail catalog
          example: '2680059592705'
          type: string
          pattern: ^\d+$
      required:
      - catalog_type
      - country
      - language
      - items
    CatalogsRetailItemErrorResponse:
      type: object
      description: Object describing a retail item error
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
        errors:
          description: Array with the errors for the item id requested
          items:
            $ref: '#/components/schemas/ItemValidationEvent'
          type: array
      required:
      - catalog_type
    CatalogsRetailItemResponse:
      type: object
      description: Object describing a retail item record
      properties:
        catalog_type:
          $ref: '#/components/schemas/CatalogsType'
        item_id:
          description: The catalog retail item id in the merchant namespace
          example: DS0294-M
          type: string
        pins:
          description: The pins mapped to the item
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/Pin'
          maxItems: 11
        attributes:
          $ref: '#/components/schemas/ItemAttributes'
      required:
      - catalog_type
    CatalogsCreateRetailItem:
      type: object
      description: An item to be created
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - CREATE
        attributes:
          $ref: '#/components/schemas/ItemAttributesRequest'
      required:
      - item_id
      - operation
      - attributes
    CatalogsUpdateRetailItem:
      type: object
      description: An item to be updated
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - UPDATE
        attributes:
          $ref: '#/components/schemas/UpdatableItemAttributes'
        update_mask:
          description: 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.
          example:
          - ad_link
          - adult
          - age_group
          - availability
          - average_review_rating
          - brand
          - checkout_enabled
          - color
          - condition
          - custom_label_0
          - custom_label_1
          - custom_label_2
          - custom_label_3
          - custom_label_4
          - description
          - free_shipping_label
          - free_shipping_limit
          - gender
          - google_product_category
          - gtin
          - item_group_id
          - last_updated_time
          - link
          - material
          - min_ad_price
          - mpn
          - number_of_ratings
          - number_of_reviews
          - pattern
          - price
          - product_type
          - sale_price
          - shipping
          - shipping_height
          - shipping_weight
          - shipping_width
          - size
          - size_system
          - size_type
          - tax
          - title
          - variant_names
          - variant_values
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/UpdateMaskFieldType'
      required:
      - item_id
      - operation
      - attributes
    CatalogsUpsertRetailItem:
      type: object
      description: An item to be upserted
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - UPSERT
        attributes:
          $ref: '#/components/schemas/ItemAttributesRequest'
      required:
      - item_id
      - operation
      - attributes
    CatalogsDeleteRetailItem:
      type: object
      description: An item to be deleted
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - DELETE
      required:
      - item_id
      - operation
    CatalogsHotelBatchRequest:
      description: Request object to update catalogs hotel items
      type: object
      additionalProperties: false
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        country:
          $ref: '#/components/schemas/Country'
        language:
          description: We recommend using the CatalogsLocale values.
          anyOf:
          - $ref: '#/components/schemas/CatalogsLocale'
          - $ref: '#/components/schemas/Language'
        items:
          minItems: 1
          maxItems: 1000
          type: array
          description: Array with catalogs item operations
          items:
            $ref: '#/components/schemas/CatalogsHotelBatchItem'
        catalog_id:
          description: Catalog id pertaining to the hotel item. If not provided, default
            to oldest hotel catalog
          example: '2680059592705'
          type: string
          pattern: ^\d+$
      required:
      - catalog_type
      - country
      - language
      - items
    CatalogsDeleteHotelItem:
      type: object
      description: A hotel item to be deleted
      properties:
        hotel_id:
          description: The catalog hotel id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - DELETE
      required:
      - hotel_id
      - operation
    CatalogsCreateHotelItem:
      type: object
      description: A hotel item to be created.
      properties:
        hotel_id:
          description: The catalog hotel id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - CREATE
        attributes:
          $ref: '#/components/schemas/CatalogsHotelAttributes'
      required:
      - hotel_id
      - operation
      - attributes
    CatalogsUpdateHotelItem:
      type: object
      description: Object describing an hotel item batch record
      properties:
        hotel_id:
          description: The catalog hotel item id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - UPDATE
        attributes:
          $ref: '#/components/schemas/CatalogsUpdatableHotelAttributes'
      required:
      - hotel_id
      - operation
      - attributes
    CatalogsUpsertHotelItem:
      type: object
      description: A hotel item to be upserted.
      properties:
        hotel_id:
          description: The catalog hotel id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - UPSERT
        attributes:
          $ref: '#/components/schemas/CatalogsHotelAttributes'
      required:
      - hotel_id
      - operation
      - attributes
    CatalogsHotelAddress:
      type: object
      properties:
        addr1:
          description: Primary street address of hotel.
          type: string
        city:
          description: City where the hotel is located.
          type: string
        region:
          description: State, county, province, where the hotel is located.
          type: string
        country:
          description: Country where the hotel is located.
          type: string
        postal_code:
          description: Required for countries with a postal code system. Postal or
            zip code of the hotel.
          type: string
    CatalogsHotelProduct:
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        metadata:
          $ref: '#/components/schemas/CatalogsHotelProductMetadata'
        pin:
          $ref: '#/components/schemas/Pin'
      required:
      - catalog_type
      - metadata
      - pin
    CatalogsHotelProductMetadata:
      type: object
      description: Hotel product metadata entity
      properties:
        hotel_id:
          description: The user-created unique ID that represents the hotel item.
          example: 123abc
          type: string
      required:
      - hotel_id
    CatalogsUpdatableHotelAttributes:
      type: object
      properties:
        name:
          description: The hotel's name.
          type: string
          nullable: true
        link:
          description: Link to the product page
          type: string
          nullable: true
        description:
          description: Brief description of the hotel.
          type: string
          nullable: true
        brand:
          description: The brand to which this hotel belongs to.
          type: string
          nullable: true
        latitude:
          description: Latitude of the hotel.
          type: number
        longitude:
          description: Longitude of the hotel.
          type: number
          nullable: true
        neighborhood:
          description: A list of neighborhoods where the hotel is located
          type: array
          nullable: true
          items:
            type: string
        address:
          description: Hotel address
          $ref: '#/components/schemas/CatalogsHotelAddress'
        custom_label_0:
          description: Custom grouping of hotels
          type: string
          nullable: true
        custom_label_1:
          description: Custom grouping of hotels
          type: string
          nullable: true
        custom_label_2:
          description: Custom grouping of hotels
          type: string
          nullable: true
        custom_label_3:
          description: Custom grouping of hotels
          type: string
          nullable: true
        custom_label_4:
          description: Custom grouping of hotels
          type: string
          nullable: true
        category:
          description: The type of property. The category can be any type of internal
            description desired.
          type: string
          nullable: true
        base_price:
          description: Base price of the hotel room per night followed by the ISO
            currency code
          type: string
          nullable: true
          example: 100 USD
        sale_price:
          description: Sale price of a hotel room per night. Used to advertise discounts
            off the regular price of the hotel.
          type: string
          nullable: true
          example: 90 USD
        guest_ratings:
          description: If specified, you must provide all properties
          $ref: '#/components/schemas/CatalogsHotelGuestRatings'
    CatalogsCreativeAssetsProductMetadata:
      type: object
      description: Creative assets product metadata entity
      properties:
        creative_assets_id:
          description: The user-created unique ID that represents the creative assets
            item.
          example: 123abc
          type: string
        visibility:
          $ref: '#/components/schemas/CreativeAssetsVisibilityType'
      required:
      - creative_assets_id
      - visibility
    CatalogsCreativeAssetsProduct:
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        metadata:
          $ref: '#/components/schemas/CatalogsCreativeAssetsProductMetadata'
        pin:
          $ref: '#/components/schemas/Pin'
      required:
      - catalog_type
      - metadata
      - pin
    CreativeAssetsVisibilityType:
      description: Creative assets visibility.
      nullable: false
      type: string
      enum:
      - VISIBLE
      - HIDDEN
    CatalogsCreativeAssetsBatchRequest:
      description: Request object to update catalogs creative assets items
      type: object
      additionalProperties: false
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        country:
          $ref: '#/components/schemas/Country'
        language:
          description: We recommend using the CatalogsLocale values.
          anyOf:
          - $ref: '#/components/schemas/CatalogsLocale'
          - $ref: '#/components/schemas/Language'
        items:
          minItems: 1
          maxItems: 1000
          type: array
          description: Array with creative assets item operations
          items:
            $ref: '#/components/schemas/CatalogsCreativeAssetsBatchItem'
        catalog_id:
          description: Catalog id pertaining to the creative assets item. If not provided,
            default to oldest creative assets catalog
          example: '2680059592705'
          type: string
          pattern: ^\d+$
      required:
      - catalog_type
      - country
      - language
      - items
    CatalogsCreativeAssetsBatchItem:
      description: Creative assets batch item
      type: object
      anyOf:
      - $ref: '#/components/schemas/CatalogsCreateCreativeAssetsItem'
      - $ref: '#/components/schemas/CatalogsUpsertCreativeAssetsItem'
      - $ref: '#/components/schemas/CatalogsUpdateCreativeAssetsItem'
      - $ref: '#/components/schemas/CatalogsDeleteCreativeAssetsItem'
      discriminator:
        propertyName: operation
        mapping:
          CREATE: '#/components/schemas/CatalogsCreateCreativeAssetsItem'
          UPSERT: '#/components/schemas/CatalogsUpsertCreativeAssetsItem'
          UPDATE: '#/components/schemas/CatalogsUpdateCreativeAssetsItem'
          DELETE: '#/components/schemas/CatalogsDeleteCreativeAssetsItem'
    CatalogsCreateCreativeAssetsItem:
      type: object
      description: A creative assets item to be created.
      properties:
        creative_assets_id:
          description: The catalog creative assets id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - CREATE
        attributes:
          $ref: '#/components/schemas/CatalogsCreativeAssetsAttributes'
      required:
      - creative_assets_id
      - operation
      - attributes
    CatalogsUpdateCreativeAssetsItem:
      type: object
      description: A creative assets item to be updated.
      properties:
        creative_assets_id:
          description: The catalog creative assets item id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - UPDATE
        attributes:
          $ref: '#/components/schemas/CatalogsUpdatableCreativeAssetsAttributes'
      required:
      - creative_assets_id
      - operation
      - attributes
    CatalogsUpsertCreativeAssetsItem:
      type: object
      description: A creative assets item to be upserted.
      properties:
        creative_assets_id:
          description: The catalog creative assets id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - UPSERT
        attributes:
          $ref: '#/components/schemas/CatalogsCreativeAssetsAttributes'
      required:
      - creative_assets_id
      - operation
      - attributes
    CatalogsDeleteCreativeAssetsItem:
      type: object
      description: A creative assets item to be deleted
      properties:
        creative_assets_id:
          description: The catalog creative assets id in the merchant namespace
          example: DS0294-M
          type: string
        operation:
          type: string
          enum:
          - DELETE
      required:
      - creative_assets_id
      - operation
    CatalogsUpdatableCreativeAssetsAttributes:
      type: object
      properties:
        title:
          description: The name of the creative assets.
          type: string
        description:
          description: Brief description of the creative assets.
          type: string
        link:
          description: Link to the creative assets page.
          type: string
        ios_deep_link:
          description: IOS deep link to the creative assets page.
          type: string
          nullable: true
        android_deep_link:
          description: Link to the creative assets page.
          type: string
          nullable: true
        google_product_category:
          description: 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.
          type: string
          nullable: true
        custom_label_0:
          description: Custom grouping of creative assets.
          type: string
          nullable: true
        custom_label_1:
          description: Custom grouping of creative assets.
          type: string
          nullable: true
        custom_label_2:
          description: Custom grouping of creative assets.
          type: string
          nullable: true
        custom_label_3:
          description: Custom grouping of creative assets.
          type: string
          nullable: true
        custom_label_4:
          description: Custom grouping of creative assets.
          type: string
          nullable: true
        visibility:
          description: "Visibility of the creative assets. Must be one of the following\
            \ values (upper or lowercase): \u2018visible\u2019, \u2018hidden\u2019\
            ."
          type: string
          nullable: true
    CatalogsCreativeAssetsAttributes:
      type: object
      allOf:
      - type: object
        properties:
          image_link:
            type: string
            description: The creative assets image.
            example: https://scene.example.com/image/image_v2.jpg
          video_link:
            type: string
            description: The creative assets video.
            example: https://scene.example.com/image/image_v2.mp4
      - $ref: '#/components/schemas/CatalogsUpdatableCreativeAssetsAttributes'
    CatalogsVerticalProductGroupCreateRequest:
      type: object
      title: catalog based
      description: Request object for creating a catalog based product group.
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailProductGroupCreateRequest'
      - $ref: '#/components/schemas/CatalogsHotelProductGroupCreateRequest'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupCreateRequest'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailProductGroupCreateRequest'
          HOTEL: '#/components/schemas/CatalogsHotelProductGroupCreateRequest'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsProductGroupCreateRequest'
    CatalogsVerticalProductGroupUpdateRequest:
      type: object
      title: catalog based
      description: Request object for updating a catalog based product group.
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailProductGroupUpdateRequest'
      - $ref: '#/components/schemas/CatalogsHotelProductGroupUpdateRequest'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsProductGroupUpdateRequest'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailProductGroupUpdateRequest'
          HOTEL: '#/components/schemas/CatalogsHotelProductGroupUpdateRequest'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsProductGroupUpdateRequest'
    CatalogsAvailableFilterValues:
      description: Object holding available filter values for each filter key
      title: catalogs_available_filter_values
      type: object
      oneOf:
      - $ref: '#/components/schemas/CatalogsRetailAvailableFilterValues'
      - $ref: '#/components/schemas/CatalogsHotelAvailableFilterValues'
      - $ref: '#/components/schemas/CatalogsCreativeAssetsAvailableFilterValues'
      discriminator:
        propertyName: catalog_type
        mapping:
          RETAIL: '#/components/schemas/CatalogsRetailAvailableFilterValues'
          HOTEL: '#/components/schemas/CatalogsHotelAvailableFilterValues'
          CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsAvailableFilterValues'
    CatalogsRetailAvailableFilterValues:
      title: catalogs_retail_available_filter_values
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - RETAIL
        filter_values:
          type: object
          title: catalogs_retail_filter_values_map
          description: A map of filter attributes to their available values.
          properties:
            ad_image_tags:
              type: array
              items:
                type: string
            ad_video_tags:
              type: array
              items:
                type: string
            brand:
              type: array
              items:
                type: string
            custom_label_0:
              type: array
              items:
                type: string
            custom_label_1:
              type: array
              items:
                type: string
            custom_label_2:
              type: array
              items:
                type: string
            custom_label_3:
              type: array
              items:
                type: string
            custom_label_4:
              type: array
              items:
                type: string
            google_product_category_0:
              type: array
              items:
                type: string
            google_product_category_1:
              type: array
              items:
                type: string
            google_product_category_2:
              type: array
              items:
                type: string
            google_product_category_3:
              type: array
              items:
                type: string
            google_product_category_4:
              type: array
              items:
                type: string
            google_product_category_5:
              type: array
              items:
                type: string
            google_product_category_6:
              type: array
              items:
                type: string
            product_type_0:
              type: array
              items:
                type: string
            product_type_1:
              type: array
              items:
                type: string
            product_type_2:
              type: array
              items:
                type: string
            product_type_3:
              type: array
              items:
                type: string
            product_type_4:
              type: array
              items:
                type: string
            gender:
              type: array
              items:
                type: string
                enum:
                - FEMALE
                - MALE
                - UNISEX
            availability:
              type: array
              items:
                type: string
                enum:
                - IN_STOCK
                - OUT_OF_STOCK
                - PREORDER
                - UNAVAILABLE
            media_type:
              type: array
              items:
                type: string
                enum:
                - IMAGE
                - VIDEO
            condition:
              type: array
              items:
                type: string
                enum:
                - NEW
                - USED
                - REFURBISHED
      required:
      - catalog_type
      - filter_values
    CatalogsHotelAvailableFilterValues:
      title: catalogs_hotel_available_filter_values
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - HOTEL
        filter_values:
          type: object
          title: catalogs_hotel_filter_values_map
          description: A map of filter attributes to their available values.
          properties:
            brand:
              type: array
              items:
                type: string
            custom_label_0:
              type: array
              items:
                type: string
            custom_label_1:
              type: array
              items:
                type: string
            custom_label_2:
              type: array
              items:
                type: string
            custom_label_3:
              type: array
              items:
                type: string
            custom_label_4:
              type: array
              items:
                type: string
      required:
      - catalog_type
      - filter_values
    CatalogsCreativeAssetsAvailableFilterValues:
      title: catalogs_creative_assets_available_filter_values
      type: object
      properties:
        catalog_type:
          type: string
          enum:
          - CREATIVE_ASSETS
        filter_values:
          type: object
          title: catalogs_creative_assets_filter_values_map
          description: A map of filter attributes to their available values.
          properties:
            custom_label_0:
              type: array
              items:
                type: string
            custom_label_1:
              type: array
              items:
                type: string
            custom_label_2:
              type: array
              items:
                type: string
            custom_label_3:
              type: array
              items:
                type: string
            custom_label_4:
              type: array
              items:
                type: string
            google_product_category_0:
              type: array
              items:
                type: string
            google_product_category_1:
              type: array
              items:
                type: string
            google_product_category_2:
              type: array
              items:
                type: string
            google_product_category_3:
              type: array
              items:
                type: string
            google_product_category_4:
              type: array
              items:
                type: string
            google_product_category_5:
              type: array
              items:
                type: string
            google_product_category_6:
              type: array
              items:
                type: string
            media_type:
              type: array
              items:
                type: string
                enum:
                - IMAGE
                - VIDEO
      required:
      - catalog_type
      - filter_values
    ConditionFilter:
      type: object
      title: CONDITION
      additionalProperties: false
      properties:
        CONDITION:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringCriteria'
      required:
      - CONDITION
    ContentType:
      type: string
      enum:
      - image/jpeg
      - image/png
    ConversionApiResponse:
      description: Schema describing the object in the response, which contains information
        about the events that were received and processed.
      type: object
      properties:
        num_events_received:
          description: Total number of events received in the request.
          type: integer
        num_events_processed:
          description: Number of events that were successfully processed from the
            events.
          type: integer
        events:
          description: Specific messages for each event received. The order will match
            the order in which the events were received in the request.
          type: array
          items:
            type: object
            properties:
              status:
                description: Whether the event was processed successfully.
                type: string
                example: processed
                enum:
                - failed
                - processed
              error_message:
                description: Error message containing more information about why the
                  event failed to be processed.
                type: string
                nullable: true
              warning_message:
                description: Warning messages about any fields in the event which
                  are not standard. These are not critical to event processing.
                type: string
                nullable: true
            required:
            - status
      required:
      - num_events_received
      - num_events_processed
      - events
    ConversionAttributionWindowDays:
      type: integer
      enum:
      - 0
      - 1
      - 7
      - 14
      - 30
      - 60
    ConversionEventResponse:
      title: ConversionEventResponse
      type: object
      properties:
        conversion_event:
          type: string
          $ref: '#/components/schemas/ConversionTagType'
        conversion_tag_id:
          title: conversion_tag_id
          description: Id of the tag.
          type: string
          pattern: ^\d+$
          example: '2614324385652'
        ad_account_id:
          title: ad_account_id
          description: Id of the ad account.
          type: string
          pattern: ^\d+$
          example: '549757463328'
        created_time:
          title: created_time
          description: Creation date in epoch format.
          type: integer
          example: 1564768710
    ConversionEvents:
      description: A list of events (one or more) encapsulated by a data object.
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          minItems: 1
          maxItems: 1000
          items:
            type: object
            additionalProperties: false
            properties:
              event_name:
                description: |
                  <p>The type of the user event. Please use the right event_name; otherwise the event will not be accepted and show up correctly in reports.
                    <ul>
                    <li><code>add_payment_info</code></li>
                    <li><code>add_to_cart</code></li>
                    <li><code>add_to_wishlist</code></li>
                    <li><code>checkout</code></li>
                    <li><code>custom</code></li>
                    <li><code>initiate_checkout</code></li>
                    <li><code>lead</code></li>
                    <li><code>page_visit</code></li>
                    <li><code>search</code></li>
                    <li><code>signup</code></li>
                    <li><code>subscribe</code></li>
                    <li><code>view_category</code></li>
                    <li><code>view_content</code></li>
                    <li><code>watch_video</code></li>
                    </ul>
                  </p>
                type: string
                example: checkout
              action_source:
                description: |
                  <p>
                    The source indicating where the conversion event occurred.
                    <ul>
                      <li><code>app_android</code></li>
                      <li><code>app_ios</code></li>
                      <li><code>web</code></li>
                      <li><code>offline</code></li>
                    </ul>
                  </p>
                type: string
                example: app_ios
              event_time:
                description: The time when the event happened. Unix timestamp in seconds.
                example: 1451431341
                type: integer
                format: int64
              event_id:
                description: A unique id string that identifies this event and can
                  be used for deduping between events ingested via both the conversion
                  API and Pinterest tracking. Without this, event's data is likely
                  to be double counted and will cause report metric inflation. Third-party
                  vendors make sure this field is updated on both Pinterest tag and
                  Conversions API side before rolling out template for Conversions
                  API.
                type: string
                example: eventId0001
              event_source_url:
                description: URL of the web conversion event.
                type: string
                example: https://www.my-clothing-shop.org/
                nullable: true
              opt_out:
                description: When action_source is web or offline, it defines whether
                  the user has opted out of tracking for web conversion events. While
                  when action_source is app_android or app_ios, it defines whether
                  the user has enabled Limit Ad Tracking on their iOS device, or opted
                  out of Ads Personalization on their Android device.
                type: boolean
                example: false
              partner_name:
                description: "The third party partner name responsible to send the\
                  \ event to Conversions API on behalf of the advertiser. The naming\
                  \ convention is \"ss-partnername\" lowercase. E.g \u2018ss-shopify\u2019"
                type: string
                example: ss-partnername
                nullable: true
              user_data:
                $ref: '#/components/schemas/ConversionEventsUserData'
              custom_data:
                description: Object containing other custom data.
                type: object
                additionalProperties: false
                properties:
                  currency:
                    description: The ISO-4217 currency code. If not provided, we will
                      default to the advertiser's currency set during account creation.
                      Your campaign performance needs this field to report right ROAS/CPA.
                    example: USD
                    type: string
                    nullable: true
                  value:
                    description: Total value of the event. Accepted as a string in
                      the request; it will be parsed into a double. For example, if
                      there are two items in a checkout event, the value should be
                      the total price. We recommend to use pre-tax, pre-shipping final
                      value.
                    example: '72.39'
                    type: string
                    nullable: true
                  content_ids:
                    description: List of products IDs. We recommend using this if
                      you are a merchant for PageVisit, AddToCart and Checkouts. For
                      detail, please check <a href="https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs"
                      target="_blank">here</a> (Install the Pinterest tag section).
                    type: array
                    items:
                      type: string
                    example:
                    - product-id-001
                    - product-id-002
                  content_name:
                    description: The name of the page or product associated with the
                      event.
                    type: string
                    nullable: true
                    example: pinterest-themed-clothing
                  content_category:
                    description: The category of the content associated with the event.
                    type: string
                    nullable: true
                    example: shirts
                  content_brand:
                    description: The brand of the content associated with the event.
                    type: string
                    nullable: true
                    example: pinterest-brand
                  contents:
                    description: A list of objects containing information about products,
                      such as price and quantity. We recommend using this if you are
                      a merchant for PageVisit, AddToCart and Checkouts. For detail,
                      please check <a href="https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs"
                      target="_blank">here</a> (Install the Pinterest tag section).
                    type: array
                    items:
                      type: object
                      additionalProperties: false
                      properties:
                        id:
                          description: The id of a product. We recommend using this
                            if you are a merchant for AddToCart and Checkouts. For
                            detail, please check <a href="https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs"
                            target="_blank">here</a> (Install the Pinterest tag section).
                          type: string
                        item_price:
                          description: The price of a product. Accepted as a string
                            in the request; it will be parsed into a double. This
                            is the original item value before any discount. We recommend
                            using this if you are a merchant for PageVisit, AddToCart
                            and Checkouts. For detail, please check <a href="https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs"
                            target="_blank">here</a> (Install the Pinterest tag section).
                          type: string
                        quantity:
                          description: The amount of a product. We recommend using
                            this if you are a merchant for AddToCart and Checkouts.
                            For detail, please check <a href="https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs"
                            target="_blank">here</a> (Install the Pinterest tag section).
                          type: integer
                          format: int64
                        item_name:
                          description: The name of a product.
                          type: string
                        item_category:
                          description: The category of a product.
                          type: string
                        item_brand:
                          description: The brand of a product.
                          type: string
                    example:
                    - id: product-id-001
                      item_price: '14.99'
                      quantity: 3
                      item_name: pinterest-shirt-girl
                      item_category: pinterest-clothing-shirts
                      item_brand: pinterest
                    - id: product-id-002
                      item_price: '13.71'
                      quantity: 2
                      item_name: pinterest-shirt-men
                      item_category: pinterest-clothing-shirts
                      item_brand: pinterest
                  num_items:
                    description: Total number of products of the event. For example,
                      the total number of items purchased in a checkout event. We
                      recommend using this if you are a merchant for AddToCart and
                      Checkouts. For detail, please check <a href="https://help.pinterest.com/en/business/article/before-you-get-started-with-catalogs"
                      target="_blank">here</a> (Install the Pinterest tag section).
                    type: integer
                    format: int64
                    example: 5
                  order_id:
                    description: The order ID. We recommend sending order_id to help
                      us deduplicate events when necessary. This also helps to run
                      other measurement products at Pinterest.
                    type: string
                    nullable: true
                    example: my_order_id
                  external_measurement_vendor_id:
                    description: Only use when instructed.
                    type: integer
                    nullable: true
                    example: 1
                  external_measurement_id:
                    description: Only use when instructed.
                    type: string
                    nullable: true
                    example: rbos-cb7a9e56-4988-4ca0-801b-05c79b29785f
                  search_string:
                    description: The search string related to the user conversion
                      event.
                    type: string
                    nullable: true
                    example: sample string
                  opt_out_type:
                    description: Flags for different privacy rights laws to opt out
                      users of sharing personal information. Separate values with
                      commas. See the Help Center article about <a href="https://help.pinterest.com/en/business/article/limited-data-processing"
                      target="_blank">limited data processing</a> and the developer's
                      guide for <a href="/docs/api-features/track-conversion-events/#opt-out-type-for-privacy"
                      target="_blank">tracking conversion events</a> for help with
                      using this parameter.
                    example: LDP
                    type: string
                    nullable: true
                  np:
                    description: Named partner. Not required, this is for Pinterest
                      internal use only. Please do not use this unless specifically
                      guided.
                    type: string
                    nullable: true
                    example: ss-company
              app_id:
                description: The app store app ID.
                type: string
                nullable: true
                example: '429047995'
              app_name:
                description: Name of the app.
                type: string
                nullable: true
                example: Pinterest
              app_version:
                description: Version of the app.
                type: string
                nullable: true
                example: '7.9'
              device_brand:
                description: Brand of the user device.
                type: string
                nullable: true
                example: Apple
              device_carrier:
                description: User device's mobile carrier.
                type: string
                nullable: true
                example: T-Mobile
              device_model:
                description: Model of the user device.
                type: string
                nullable: true
                example: iPhone X
              device_type:
                description: Type of the user device.
                type: string
                nullable: true
                example: iPhone
              os_version:
                description: Version of the device operating system.
                type: string
                nullable: true
                example: 12.1.4
              wifi:
                description: Whether the event occurred when the user device was connected
                  to wifi.
                example: false
                type: boolean
              language:
                description: Two-character ISO-639-1 language code indicating the
                  user's language.
                example: en
                type: string
                nullable: true
              device_info:
                $ref: '#/components/schemas/ConversionEventDeviceInfo'
              app_info:
                $ref: '#/components/schemas/ConversionEventAppInfo'
            required:
            - event_name
            - action_source
            - event_time
            - user_data
            - event_id
      required:
      - data
    ConversionEventsUserData:
      description: Object containing customer information data. Note, It is required
        at least one of 1) em, 2) hashed_maids or 3) pair client_ip_address + client_user_agent.
      type: object
      anyOf:
      - $ref: '#/components/schemas/ConversionEventsUserDataProperties'
        required:
        - em
        title: EMConversionEventsUserDataPropertyRequired
      - $ref: '#/components/schemas/ConversionEventsUserDataProperties'
        required:
        - hashed_maids
        title: HashedMaidsConversionEventsUserDataPropertyRequired
      - $ref: '#/components/schemas/ConversionEventsUserDataProperties'
        required:
        - client_ip_address
        - client_user_agent
        title: ClientIPAddressConversionEventsUserDataPropertyRequired
    ConversionEventAppInfo:
      description: Object containing information about the application where event
        occurred.
      type: object
      additionalProperties: false
      properties:
        app_name:
          description: Name of the app. Primarily used for Mobile Apps.
          type: string
          maxLength: 200
          example: MyAwesomeApp
        app_package_name:
          description: App package name
          type: string
          maxLength: 200
          example: com.company.myawesomeapp
        app_id:
          description: App ID in Google Play Store, AppStore or other stores.
          type: string
          maxLength: 200
          example: '429047995'
        app_version:
          description: App version. Primarily used for mobile apps
          type: string
          maxLength: 100
          example: '7.9'
        app_store:
          description: |-
            The name of the app distributor or store from which the app was installed.
            Some options: Samsung Galaxy Store, Google Play Store, Amazon Store, Apple App Store, F-Droid, Aptoide, Obtanium, Huawei AppGallery, Xiaomi Mi GetApps
          type: string
          maxLength: 100
          example: Google Play Store
        window_width:
          description: Inner width of the window or viewport.
          type: integer
          minimum: 0
          maximum: 30720
          example: 1678
        window_height:
          description: Inner height of the window or viewport.
          type: integer
          minimum: 0
          maximum: 30720
          example: 900
        install_time:
          description: App install time. Unix timestamp in seconds
          type: integer
          minimum: 0
          example: 1739222269
        user_agent:
          description: User Agent request header. Primarily used for Web events
          type: string
          maxLength: 16384
          example: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,
            like Gecko) Chrome/131.0.0.0 Safari/537.36
    ConversionEventDeviceInfo:
      description: Object containing information about the device where event occurred.
      type: object
      additionalProperties: false
      properties:
        brand:
          description: Device brand
          type: string
          maxLength: 100
          example: Apple, Samsung, Motorola
        type:
          description: Device type
          type: string
          maxLength: 100
          example: iPhone, Android
        model:
          description: Device model name
          type: string
          maxLength: 100
          example: 16 Pro, Galaxy S25 Ultra
        form_factor:
          description: Device form factor
          type: string
          enum:
          - desktop
          - laptop
          - cellphone
          - tablet
          - smartwatch
          - tv
          - vr
          - console
          - other
          example: cellphone
        os_family:
          description: OS Family
          type: string
          enum:
          - ios
          - android
          - macos
          - windows
          - linux
          - bsd
          - other
          example: ios
        os_name:
          description: |-
            Short name of the OS.
            This value if specific to os family. Examples:
            Windows: 10, 11; Android: 16; iOS: 18; MacOS: 15; Linux: Debian, Ubuntu, Arch
          type: string
          maxLength: 100
          example: '10'
        os_version:
          description: |-
            Full name of the version. Examples:
            iOS: 18.3
            Android: 16.1
            MacOS: 15.5
            Windows: 24H2
            Ubuntu Linux: 25.04
          type: string
          maxLength: 100
          example: '18.3'
        os_release_name:
          description: |-
            Marketing name for the release version
            iOS: Dawn
            Android: Baklava
            MacOS: Sequoia
            Ubuntu Linux: Plucky Puffin
          type: string
          maxLength: 100
          example: '18.3'
        kernel_version:
          description: |-
            Kernel version. Examples:
            Linux: 6.15. Obtain by running: uname -r
            MacOS: 24.3.0. Obtain by running: sysctl kern.version
            Android: 6.6. Obtain from OS.uname().release
          type: string
          maxLength: 100
          example: '6.15'
        carrier:
          description: User device's mobile carrier.
          type: string
          maxLength: 100
          example: T-Mobile
        screen_width:
          description: Screen width in pixels
          type: integer
          minimum: 0
          maximum: 30720
          example: 1320
        screen_height:
          description: Screen height in pixels
          type: integer
          minimum: 0
          maximum: 30720
          example: 2868
        screen_density:
          description: Screen density, PPI
          type: integer
          minimum: 0
          maximum: 100000
          example: 460
        cpu_cores:
          description: Number of CPU cores
          type: integer
          minimum: 0
          maximum: 1152
          example: 8
        storage_size:
          description: Internal storage size in GB
          type: integer
          minimum: 0
          maximum: 1048576
          example: 256
        storage_free_space:
          description: Internal storage size in GB
          type: integer
          minimum: 0
          maximum: 1048576
          example: 184
        external_storage_size:
          description: External storage size in GB
          type: integer
          minimum: 0
          maximum: 1048576
          example: 512
        external_storage_free_space:
          description: External storage size in GB
          type: integer
          minimum: 0
          maximum: 1048576
          example: 126
        locale:
          description: Device locale BCP-47 format
          type: string
          maxLength: 35
          example: en-us
        languages:
          description: List of user installed languages. ISO 639-1 format
          type: array
          items:
            type: string
          example:
          - en
          - de
          - lt
          minItems: 0
          maxItems: 100
        timezone:
          description: Device timezone
          type: string
          maxLength: 40
          example: USA/New York
        timezone_abbr:
          description: Timezone abbreviation
          type: string
          maxLength: 5
          example: PDT
        network_type:
          description: |-
            Network type: 4G, 5G, ethernet, wifi
            In Android: NetworkCapabilities.getNetworkCapabilities()
          type: string
          enum:
          - wifi
          - cellular_2g
          - cellular_3g
          - cellular_4g
          - cellular_5g
          - cellular_6g
          - ethernet
          - unknown
          example: wifi
        battery_level:
          description: Battery charge level percentage
          type: integer
          minimum: 0
          maximum: 100
          example: 78
    ConversionEventsUserDataProperties:
      type: object
      properties:
        em:
          description: Sha256 hashes of lowercase version of user's email addresses.
            Used for matching. We highly recommend this on checkout events at least.
            It may improve reporting performance such as ROAS/CPA. The string should
            be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - 411e44ce1261728ffd2c0686e44e3fffe413c0e2c5adc498bc7da883d476b9c8
          - 09831ea51bd1b7b32a836683a00a9ccaf3d05f59499f42d9883412ed79289969
        hashed_maids:
          description: Sha256 hashes of user's "Google Advertising IDs" (GAIDs) or
            "Apple's Identifier for Advertisers" (IDFAs). Used for matching. We highly
            recommend this on checkout events at least. It may improve reporting performance
            such as ROAS/CPA. The string should be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - 0192518eb84137ccfe82c8b6322d29631dae7e28ed9d0f6dd5f245d73a58c5f1
          - 837b850ac46d62b2272a71de73c27801ff011ac1e36c5432620c8755cf90db46
        client_ip_address:
          description: The user's IP address, which can be either in IPv4 or IPv6
            format. Used for matching. We highly recommend this for all events. It
            may improve reporting performance such as ROAS/CPA.
          type: string
          example: 216.3.128.12
        client_user_agent:
          description: The user agent string of the user's web browser. We highly
            recommend this for all events. It may improve reporting performance such
            as ROAS/CPA.
          type: string
        ph:
          description: Sha256 hashes of user's phone numbers, only digits with country
            code, area code, and number. Remove any symbols, letters, spaces and leading
            zeros. We highly recommend this on checkout events at least. It may improve
            reporting performance such as ROAS/CPA. The string should be in the UTF-8
            format.
          type: array
          items:
            type: string
          example:
          - 45df139772a81b6011bdc1c9cc3d1cb408fc0b10ec0c5cb9d4d4e107f0ddc49d
        ge:
          description: Sha256 hashes of user's gender, in lowercase. Either "f" or
            "m" or "n" for non-binary gender. The string should be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - 0d248e82c62c9386878327d491c762a002152d42ab2c391a31c44d9f62675ddf
        db:
          description: Sha256 hashes of user's date of birthday, given as year, month,
            and day. The string should be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - d4426a0086d10f12ad265539ae8d54221dc67786053d511407204b76e99d7739
        ln:
          description: Sha256 hashes of user's last name, in lowercase. We highly
            recommend this on checkout events at least. It may improve reporting performance
            such as ROAS/CPA. The string should be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - 7e546b3aa43f989dd359672e6c3409d4f9d4e8f155ae1e9b90ee060985468c19
        fn:
          description: Sha256 hashes of user's first name, in lowercase. We highly
            recommend this on checkout events at least. It may improve reporting performance
            such as ROAS/CPA. The string should be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - ec1e6a072231703f1bc41429052fff8c00a7e0c6aaec2e7107241ca8f3ceb6b2
        ct:
          description: Sha256 hashes of user's city, in lowercase, and without spaces
            or punctuation. User residency city (mostly billing). The string should
            be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - 4ac01a129bfd10385c9278c2cf2c46fac5ab57350841234f587c8522a2e4ce36
        st:
          description: Sha256 hashes of user's state, given as a two-letter code in
            lowercase. User residency state (mostly billing). The string should be
            in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - 49a6d05b8e4b516656e464271d9dd38d0a7e0142f7f49546f4dabd2720cafc34
        zp:
          description: Sha256 hashes of user's zipcode, only digits. User residency
            zipcode (mostly billing). The string should be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - fd5f56b40a79a385708428e7b32ab996a681080a166a2206e750eb4819186145
        country:
          description: Sha256 hashes of two-character ISO-3166 country code indicating
            the user's country, in lowercase. The string should be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - 9b202ecbc6d45c6d8901d989a918878397a3eb9d00e8f48022fc051b19d21a1d
        external_id:
          description: Sha256 hashes of the unique id from the advertiser that identifies
            a user in their space, e.g. user id, loyalty id, etc. We highly recommend
            this on all events. It may improve reporting performance such as ROAS/CPA.
            The string should be in the UTF-8 format.
          type: array
          items:
            type: string
          example:
          - 6a7a73766627eb611720883d5a11cc62b5bfee237b00a6658d78c50032ec4aee
        click_id:
          description: The unique identifier stored in _epik cookie on your domain
            or &epik= query parameter in the URL. We highly recommend this on checkout
            events at least. It may improve reporting performance such as ROAS/CPA.
          type: string
          example: dj0yJnU9b2JDcFFHekV4SHJNcmVrbFBkUEdqakh0akdUT1VjVVUmcD0yJm49cnNBQ3F2Q2dOVDBXWWhkWklrUGxBUSZ0PUFBQUFBR1BaY3Bv
          nullable: true
        partner_id:
          description: A unique identifier of visitors' information defined by third
            party partners. e.g RampID
          type: string
          example: BUJrTlRRzGJmWhRXFZdkioV6wKPBve7Lom__GU9J74hq2NIQj4O3nOZJrp3mcUr5MptkXsI14juMOIM9mNZnM4zEUFT2JLVaFhcOfuuWz3IWEDtBf6I0DPc
          nullable: true
    ConversionMSOTEvents:
      title: Conversion MSOT Events
      description: Object containing the MSOT conversion events.
      type: object
      additionalProperties: false
      properties:
        event_id:
          description: A unique id string that identifies this event. If you are already
            sending us events through Conversions API, then this id should match the
            event_id sent through Conversions API.
          type: string
          maxLength: 256
          example: eventId0001
        event_name:
          description: Type of user event.
          type: string
          enum:
          - add_to_cart
          - checkout
          - lead
          - signup
          example: add_to_cart
        event_timestamp:
          description: The time when the event occurred. Unix timestamp in seconds.
          type: integer
          format: int64
          example: 1451431341
        ad_group_id:
          description: The ID of the ad group that was attributed to the conversion
            event.
          type: string
          pattern: ^\d+$
          example: '2680060704746'
        attribution_scope:
          description: Ad event type.
          type: string
          enum:
          - view
          - engagement
          - click
          example: click
        value:
          description: Order value of the conversion event. Required if <code>event_name</code>
            is 'add_to_cart' or 'checkout'.
          type: number
          format: double
          example: 123.45
        currency:
          allOf:
          - $ref: '#/components/schemas/Currency'
          - type: string
            description: Currency code for the value field, required if <code>value</code>
              is present. Currency Codes should be in ISO 4217 standard.
        campaign_id:
          description: The ID of the campaign that was attributed to the conversion
            event.
          type: string
          pattern: ^\d+$
          example: '626736533506'
        action_timestamps:
          description: Timestamp(s) when the ad action(s) happened. Unix timestamp
            in seconds.
          type: array
          items:
            type: integer
            format: int64
          example:
          - 1451410040
        attribution_model:
          description: The attribution model used to attribute the conversion event.
          type: string
          enum:
          - first_touch
          - last_touch
          - multi_touch
          example: multi_touch
        attribution_score:
          description: Credit given to the attributed ad actions. Allowed values are
            > 0 and <= 1.
          type: number
          format: double
          minimum: 0
          exclusiveMinimum: true
          maximum: 1
          example: 0.5
        total_events:
          description: |-
            Total number of conversion events that are reported in one API call.
            <p>If you are sending one API request for one attributed conversion event then this value should be 1.</p>
            <p>If you are sending multiple attributed conversion events in one API request then this value should be the total number of attributed conversion events in the request.</p>
          type: integer
          minimum: 1
          example: 2
        total_event_touchpoints:
          description: Total number of ad events including other non-Pinterest ad
            platforms.
          type: integer
          minimum: 1
          example: 2
      required:
      - event_id
      - event_name
      - event_timestamp
      - ad_group_id
      - attribution_scope
    ConversionProductReportRequest:
      type: object
      description: Request for a brand, category, SKU report
      properties:
        report_name:
          description: Name of the conversion product report.
          type: string
        start_date:
          description: 'Metric report start date (UTC). Format: YYYY-MM-DD.<br> Start
            date must be after 2024-03-16. 7 day minimum time window for report is
            required.'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
          example: '2024-03-17'
        end_date:
          description: 'Metric report end date (UTC). Format: YYYY-MM-DD.<br> A max
            of 1 year is allowed between the start and end date for reports.'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
          example: '2024-04-23'
        granularity:
          description: TOTAL - metrics are aggregated over the specified date range.<br>
            WEEK - metrics are broken down weekly.<br> MONTH - metrics are broken
            down monthly.
          type: string
          enum:
          - WEEK
          - MONTH
          - TOTAL
        level:
          description: Level of the report
          type: string
          enum:
          - ADVERTISER
          - CAMPAIGN
          - AD_GROUP
        columns:
          description: Metric and entity columns
          type: array
          items:
            $ref: '#/components/schemas/ConversionProductReportingColumn'
        click_window_days:
          description: Number of days to use as the conversion attribution window
            for a pin click action. Applies to Pinterest Tag conversion metrics. Prior
            conversion tags use their defined attribution windows. If not specified,
            defaults to `30` days.
          type: integer
          allOf:
          - $ref: '#/components/schemas/ConversionAttributionWindowDays'
          default: 30
        view_window_days:
          description: Number of days to use as the conversion attribution window
            for a view action. Applies to Pinterest Tag conversion metrics. Prior
            conversion tags use their defined attribution windows. If not specified,
            defaults to `30` day.
          type: integer
          allOf:
          - $ref: '#/components/schemas/ConversionAttributionWindowDays'
          default: 30
        conversion_report_time:
          description: 'The date by which the conversion metrics returned from this
            endpoint will be reported. There are two dates associated with a conversion
            event: the date that the user interacted with the ad, and the date that
            the user completed a conversion event.'
          type: string
          allOf:
          - $ref: '#/components/schemas/ConversionReportTimeType'
          default: TIME_OF_AD_ACTION
        conversion_product_breakdown:
          description: Report breakdown type. This is used to specify the breakdown
            of the report by brand, category, or SKU.
          type: string
          allOf:
          - type: string
            enum:
            - PRODUCT_BRAND
            - PRODUCT_CATEGORY
            - PRODUCT_BRAND_AND_CATEGORY
            - PRODUCT_SKU
            - PRODUCT_SKU_GROUP
          default: PRODUCT_BRAND
        conversion_product_attribution_type:
          description: Required attribution type of the B/C/S report.<br>When the
            attribution type is BRAND_ATTRIBUTION, start_date for the report must
            be after 2025-04-01.
          allOf:
          - type: string
            enum:
            - DEFAULT
            - BRAND_ATTRIBUTION
          default: DEFAULT
          enum:
          - DEFAULT
          - BRAND_ATTRIBUTION
        campaign_objective_types:
          type: array
          description: List of values for filtering. Default is ['CONSIDERATION','AWARENESS','WEB_CONVERSION','VIDEO_COMPLETION'].
          items:
            $ref: '#/components/schemas/ObjectiveType'
          maxItems: 7
          minItems: 1
        campaign_ids:
          type: array
          description: List of campaign ids. <br>Only support campaign_ids field when
            level of the report is CAMPAIGN.
          example:
          - '12345678'
          items:
            type: string
            pattern: ^\d+$
          maxItems: 500
          minItems: 1
        ad_group_ids:
          type: array
          description: List of ad group ids. <br>Only support ad_group_ids field when
            level of the report is AD_GROUP.
          example:
          - '12345678'
          items:
            type: string
            pattern: ^\d+$
          maxItems: 500
          minItems: 1
        product_sku_ids:
          type: array
          description: List of SKU ids. <br>Only support product_sku_ids field when
            report breakdown type is PRODUCT_SKU_GROUP.
          example:
          - WBC45678
          - WBC45679
          items:
            type: string
            pattern: ^[a-zA-Z0-9]+$
          maxItems: 500
          minItems: 2
      required:
      - report_name
      - start_date
      - end_date
      - granularity
      - level
      - columns
    ConversionProductReportingColumn:
      type: string
      description: Conversion Product Reporting columns
      example: AD_GROUP_ID
      enum:
      - CAMPAIGN_NAME
      - CAMPAIGN_ID
      - ADVERTISER_ID
      - AD_GROUP_ID
      - CAMPAIGN_OBJECTIVE_TYPE
      - AD_GROUP_NAME
      - CONVERSION_PRODUCT_ID
      - CONVERSION_PRODUCT_BRAND
      - CONVERSION_PRODUCT_CATEGORY
      - CONVERSION_PRODUCT_ID_GROUP
      - TOTAL_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_CONVERSION_PRODUCT_VALUE
      - TOTAL_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_CHECKOUT_CONVERSION_PRODUCT_VALUE
      - TOTAL_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_CHECKOUT_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_CHECKOUT_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_CHECKOUT_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_ADD_TO_CART_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_ADD_TO_CART_CONVERSION_PRODUCT_VALUE
      - TOTAL_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_ADD_TO_CART_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_ADD_TO_CART_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_ADD_TO_CART_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_ADD_TO_CART_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_PAGE_VISIT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_PAGE_VISIT_CONVERSION_PRODUCT_VALUE
      - TOTAL_PAGE_VISIT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_PAGE_VISIT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_PAGE_VISIT_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_PAGE_VISIT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_SIGNUP_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_SIGNUP_CONVERSION_PRODUCT_VALUE
      - TOTAL_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_SIGNUP_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_SIGNUP_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_SIGNUP_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_SIGNUP_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_SIGNUP_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_SIGNUP_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WATCH_VIDEO_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE
      - TOTAL_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_WATCH_VIDEO_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_LEAD_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_LEAD_CONVERSION_PRODUCT_VALUE
      - TOTAL_LEAD_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_LEAD_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_LEAD_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_LEAD_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_LEAD_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_LEAD_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_LEAD_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_SEARCH_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_SEARCH_CONVERSION_PRODUCT_VALUE
      - TOTAL_SEARCH_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_SEARCH_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_SEARCH_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_SEARCH_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_SEARCH_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_SEARCH_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_SEARCH_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_VIEW_CATEGORY_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE
      - TOTAL_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_VIEW_CATEGORY_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_CUSTOM_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_CUSTOM_CONVERSION_PRODUCT_VALUE
      - TOTAL_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_CUSTOM_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_CUSTOM_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_CUSTOM_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_CUSTOM_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_UNKNOWN_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_UNKNOWN_CONVERSION_PRODUCT_VALUE
      - TOTAL_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_UNKNOWN_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_UNKNOWN_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_UNKNOWN_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_UNKNOWN_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_UNKNOWN_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_UNKNOWN_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE
      - TOTAL_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_ADD_TO_WISHLIST_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE
      - TOTAL_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_ADD_TO_WISHLIST_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_ADD_TO_WISHLIST_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_ADD_TO_WISHLIST_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INITIATE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE
      - TOTAL_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_INITIATE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_INITIATE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_INITIATE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_SUBSCRIBE_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_SUBSCRIBE_CONVERSION_PRODUCT_VALUE
      - TOTAL_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_SUBSCRIBE_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_SUBSCRIBE_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_SUBSCRIBE_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_SUBSCRIBE_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_SUBSCRIBE_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_SUBSCRIBE_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_VIEW_CONTENT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE
      - TOTAL_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_WEB_VIEW_CONTENT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_WEB_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE
      - TOTAL_WEB_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_INAPP_VIEW_CONTENT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_INAPP_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE
      - TOTAL_INAPP_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_USD
      - TOTAL_OFFLINE_VIEW_CONTENT_CONVERSION_PRODUCT_QUANTITY
      - TOTAL_OFFLINE_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE
      - TOTAL_OFFLINE_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_USD
    ConversionReportAttributionType:
      type: string
      description: Attribution type. Refers to the Pinterest Tag endpoints
      example: INDIVIDUAL
      enum:
      - INDIVIDUAL
      - HOUSEHOLD
    ConversionReportTimeType:
      type: string
      description: Conversion report time type
      example: TIME_OF_AD_ACTION
      enum:
      - TIME_OF_AD_ACTION
      - TIME_OF_CONVERSION
    ConversionTagCommon:
      type: object
      properties:
        ad_account_id:
          description: Ad account ID.
          example: '549755885175'
          title: ad_account_id
          type: string
        code_snippet:
          description: Tag code snippet.
          example: <script type=text/javascript> [...]
          title: code_snippet
          type: string
        enhanced_match_status:
          $ref: '#/components/schemas/EnhancedMatchStatusType'
        id:
          description: Tag ID.
          example: '2617998078212'
          title: id
          type: string
        last_fired_time_ms:
          description: Time for the last event fired.
          example: 1599030000000
          nullable: true
          title: last_fired_time_ms
          type: number
        name:
          description: Conversion tag name.
          example: ACME Checkout Test Tag
          title: name
          type: string
        status:
          $ref: '#/components/schemas/EntityStatus'
        version:
          description: Version number.
          example: '3'
          title: version
          type: string
        configs:
          $ref: '#/components/schemas/ConversionTagConfigs'
      title: ConversionTagCommon
    ConversionTagConfigs:
      type: object
      properties:
        aem_enabled:
          description: Whether Automatic Enhanced Match email is enabled. See <a href="https://help.pinterest.com/en/business/article/enhanced-match"
            target="_blank">Enhanced match</a> for more information.
          example: true
          title: aem_enabled
          type: boolean
          default: false
          nullable: true
        md_frequency:
          description: Metadata ingestion frequency.
          example: 0.6
          title: md_frequency
          type: number
          default: 1
          nullable: true
        aem_fnln_enabled:
          description: Whether Automatic Enhanced Match name is enabled. See <a href="https://help.pinterest.com/en/business/article/enhanced-match"
            target="_blank">Enhanced match</a> for more information.
          example: true
          title: aem_fnln_enabled
          type: boolean
          default: false
          nullable: true
        aem_ph_enabled:
          description: Whether Automatic Enhanced Match phone is enabled. See <a href="https://help.pinterest.com/en/business/article/enhanced-match"
            target="_blank">Enhanced match</a> for more information.
          example: true
          title: aem_ph_enabled
          type: boolean
          default: false
          nullable: true
        aem_ge_enabled:
          description: Whether Automatic Enhanced Match gender is enabled. See <a
            href="https://help.pinterest.com/en/business/article/enhanced-match" target="_blank">Enhanced
            match</a> for more information.
          example: true
          title: aem_ge_enabled
          type: boolean
          default: false
          nullable: true
        aem_db_enabled:
          description: Whether Automatic Enhanced Match birthdate is enabled. See
            <a href="https://help.pinterest.com/en/business/article/enhanced-match"
            target="_blank">Enhanced match</a> for more information.
          example: true
          title: aem_db_enabled
          type: boolean
          default: false
          nullable: true
        aem_loc_enabled:
          description: Whether Automatic Enhanced Match location is enabled. See <a
            href="https://help.pinterest.com/en/business/article/enhanced-match" target="_blank">Enhanced
            match</a> for more information.
          example: true
          title: aem_loc_enabled
          type: boolean
          default: false
          nullable: true
        aem_external_id_enabled:
          description: Whether Automatic Enhanced Match location is enabled. See <a
            href="https://help.pinterest.com/en/business/article/enhanced-match" target="_blank">Enhanced
            match</a> for more information.
          example: true
          title: aem_external_id_enabled
          type: boolean
          default: false
          nullable: true
      title: ConversionTagConfigs
    ConversionTagCreate:
      type: object
      allOf:
      - $ref: '#/components/schemas/ConversionTagConfigs'
      example:
        name: ACME Tools Tag
      properties:
        name:
          description: Conversion tag name.
          example: ACME Tools Tag
          title: name
          type: string
      required:
      - name
      title: ConversionTagCreate
    ConversionTagListResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ConversionTagResponse'
    ConversionTagResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/ConversionTagCommon'
      title: ConversionTagResponse
    ConversionTagType:
      title: ConversionTagType
      description: conversion tag type
      type: string
      enum:
      - PAGE_LOAD
      - UNKNOWN
      - INITIALIZED
      - PAGE_VISIT
      - SIGNUP
      - CHECKOUT
      - CUSTOM
      - VIEW_CATEGORY
      - SEARCH
      - ADD_TO_CART
      - WATCH_VIDEO
      - LEAD
      - APP_INSTALL
      - WEB_SESSION
      - EXTERNAL_MEASUREMENT
      example: PAGE_LOAD
    ConversionTagsOcpmEligibleResponse:
      type: object
      additionalProperties:
        type: array
        items:
          $ref: '#/components/schemas/ConversionEventResponse'
      example:
        '12345':
        - conversion_event: PAGE_LOAD
          created_time: 1564768710
          conversion_tag_id: '2614324385652'
          ad_account_id: '549757463328'
        - conversion_event: CHECKOUT
          created_time: 1564710210
          conversion_tag_id: '2614324315793'
          ad_account_id: '549757463328'
    Country:
      type: string
      description: Country ID from ISO 3166-1 alpha-2.
      example: US
      enum:
      - 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
    CountryFilter:
      type: object
      title: COUNTRY
      additionalProperties: false
      properties:
        COUNTRY:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleCountriesCriteria'
      required:
      - COUNTRY
    CreateAssetAccessRequestBody:
      type: object
      description: An object containing a list of all the asset access requests
      required:
      - asset_requests
      properties:
        asset_requests:
          type: array
          minItems: 1
          maxItems: 100
          items:
            type: object
            required:
            - partner_id
            - asset_id_to_permissions
            properties:
              partner_id:
                description: Unique identifier of a business partner to request asset
                  access to.
                example: '809944451643622187'
                type: string
                pattern: ^\d+$
              asset_id_to_permissions:
                $ref: '#/components/schemas/AssetIdToPermissions'
    CreateAssetAccessRequestErrorMessage:
      type: array
      description: A list of errors associated with the asset access requests. Will
        be returned if there is an error.
      nullable: true
      items:
        type: object
        properties:
          code:
            type: integer
            description: Error code associated with the error in requesting asset
              access.
            example: 2932
          messages:
            type: array
            example:
            - 'Invalid asset id: 549760723247'
            - 'Invalid asset id: 546760723248'
            items:
              type: string
    CreateAssetAccessRequestResponse:
      type: object
      properties:
        exceptions:
          $ref: '#/components/schemas/CreateAssetAccessRequestErrorMessage'
        invites:
          type: object
          nullable: true
          additionalProperties:
            description: An object mapping each partner id to the asset access request
              id. Only one request id is returned per partner.
            type: string
            pattern: ^\d+$
          example:
            '766456567741825556': '5349280584552211583'
            '733242520489967216': '5349280584552211845'
    CreateAssetGroupBody:
      type: object
      properties:
        asset_group_name:
          description: Asset Group name
          example: Canada Ad Accounts
          type: string
        asset_group_description:
          description: Asset group description
          example: Asset groups that has ad accounts shared in Canada
          type: string
        asset_group_types:
          $ref: '#/components/schemas/AssetGroupTypes'
      required:
      - asset_group_types
      - asset_group_description
      - asset_group_name
    CreateAssetGroupResponse:
      type: object
      properties:
        asset_group:
          $ref: '#/components/schemas/AssetGroupBinding'
    CreateInvitesResultsResponseArray:
      type: object
      properties:
        items:
          type: array
          description: List of invite/request creation status. If there is an error,
            an exception object will be returned. If the action was successfully completed,
            an invite object will be returned.
          items:
            type: object
            properties:
              exception:
                $ref: '#/components/schemas/InviteExceptionResponse'
              invite:
                type: object
                description: An invite object if the invite/request was successfully
                  created. Will only be provided if the an invite/request is successfully
                  created.
                nullable: true
                properties:
                  id:
                    type: string
                    description: Unique identifier of the invite/request.
                    example: '383791336903426391'
                    pattern: ^\d+$
                  user:
                    type: object
                    description: Metadata for the member/partner that was sent the
                      invite/request.
                    allOf:
                    - $ref: '#/components/schemas/BusinessAccessUserSummary'
    CreateMembershipOrPartnershipInvitesBody:
      description: Body to be used on path to send Members or Partners Invite or Request
      required:
      - business_role
      - invite_type
      properties:
        business_role:
          type: string
          description: |-
            The business access level to grant member/partner. Note, values are case-sensitive.
            - EMPLOYEE: Can only view and access assets you assign them to. They cannot see details about other employees, partners, or other assets.
            - BIZ_ADMIN: Have full control of roles and can add employees and partners as well as grant asset access.
            - PARTNER: Can only view and access assets you assign them to/or they assign to you.
          example: BIZ_ADMIN
          enum:
          - EMPLOYEE
          - BIZ_ADMIN
          - PARTNER
        invite_type:
          $ref: '#/components/schemas/InviteType'
        members:
          description: A list of usernames, emails, or a mix of them. Should be used
            if invite_type is MEMBER_INVITE
          example:
          - business0101
          - user@business.com
          items:
            type: string
          type: array
          minItems: 1
          maxItems: 50
        partners:
          description: A list of partner_id. Should be used if invite_type is PARTNER_INVITE
            or PARTNER_REQUEST
          example:
          - '809944451643622187'
          - '766456567741825556'
          items:
            type: string
            maxLength: 25
            pattern: ^\d+$
          minItems: 1
          maxItems: 50
          type: array
      type: object
    CreateMMMReportRequest:
      type: object
      allOf:
      - type: object
        properties:
          countries:
            type: array
            description: A List of countries for filtering
            items:
              $ref: '#/components/schemas/TargetingAdvertiserCountry'
      properties:
        report_name:
          description: Name of the Marketing Mix Modeling (MMM) report
          title: report_name
          type: string
        start_date:
          description: 'Metric report start date (UTC). Format: YYYY-MM-DD'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
          example: '2020-12-20'
        end_date:
          description: 'Metric report end date (UTC). Format: YYYY-MM-DD'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
          example: '2020-12-20'
        granularity:
          description: DAY - metrics are broken down daily.<br> WEEK - metrics are
            broken down weekly.
          type: string
          enum:
          - DAY
          - WEEK
        level:
          description: Level of the report
          type: string
          enum:
          - CAMPAIGN_TARGETING
          - AD_GROUP_TARGETING
        targeting_types:
          description: List of targeting types
          example:
          - GENDER
          items:
            $ref: '#/components/schemas/MMMReportingTargetingType'
          maxItems: 5
          minItems: 1
          title: targeting_types
          type: array
        columns:
          description: Metric and entity columns
          type: array
          items:
            $ref: '#/components/schemas/MMMReportingColumn'
      required:
      - report_name
      - start_date
      - end_date
      - granularity
      - level
      - targeting_types
      - columns
    CreateMMMReportResponse:
      type: object
      properties:
        code:
          example: 0
          type: number
        data:
          title: CreateMMMReportResponseData
          type: object
          properties:
            report_status:
              type: string
              allOf:
              - $ref: '#/components/schemas/BulkReportingJobStatus'
            token:
              type: string
            message:
              type: string
              nullable: true
            status:
              example: success
              type: string
    CreativeType:
      type: string
      enum:
      - REGULAR
      - VIDEO
      - SHOPPING
      - CAROUSEL
      - MAX_VIDEO
      - SHOP_THE_PIN
      - COLLECTION
      - IDEA
      - SHOWCASE
      - QUIZ
      description: |-
        Ad creative type enum.
        **Note:** SHOP_THE_PIN has been deprecated. Please use COLLECTION instead.
      title: CreativeType enum used ads
    Currency:
      type: string
      description: Currency Codes from ISO 4217
      example: USD
      enum:
      - UNK
      - USD
      - GBP
      - CAD
      - EUR
      - AUD
      - NZD
      - SEK
      - ILS
      - CHF
      - HKD
      - JPY
      - SGD
      - KRW
      - NOK
      - DKK
      - PLN
      - RON
      - HUF
      - CZK
      - BRL
      - MXN
      - ARS
      - CLP
      - COP
      - INR
      - TRY
    CurrencyFilter:
      type: object
      title: CURRENCY
      additionalProperties: false
      properties:
        CURRENCY:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupCurrencyCriteria'
      required:
      - CURRENCY
    CustomColumnId:
      description: Custom Column ID
      example: '123456789'
      type: string
    CustomLabel0Filter:
      type: object
      title: CUSTOM_LABEL_0
      additionalProperties: false
      properties:
        CUSTOM_LABEL_0:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupFilterOperatorTypeCriteria'
      required:
      - CUSTOM_LABEL_0
    CustomLabel1Filter:
      type: object
      title: CUSTOM_LABEL_1
      additionalProperties: false
      properties:
        CUSTOM_LABEL_1:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupFilterOperatorTypeCriteria'
      required:
      - CUSTOM_LABEL_1
    CustomLabel2Filter:
      type: object
      title: CUSTOM_LABEL_2
      additionalProperties: false
      properties:
        CUSTOM_LABEL_2:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupFilterOperatorTypeCriteria'
      required:
      - CUSTOM_LABEL_2
    CustomLabel3Filter:
      type: object
      title: CUSTOM_LABEL_3
      additionalProperties: false
      properties:
        CUSTOM_LABEL_3:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupFilterOperatorTypeCriteria'
      required:
      - CUSTOM_LABEL_3
    CustomLabel4Filter:
      type: object
      title: CUSTOM_LABEL_4
      additionalProperties: false
      properties:
        CUSTOM_LABEL_4:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupFilterOperatorTypeCriteria'
      required:
      - CUSTOM_LABEL_4
    CustomNumber0Filter:
      type: object
      title: CUSTOM_NUMBER_0
      additionalProperties: false
      properties:
        CUSTOM_NUMBER_0:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupUint32Criteria'
      required:
      - CUSTOM_NUMBER_0
    CustomNumber1Filter:
      type: object
      title: CUSTOM_NUMBER_1
      additionalProperties: false
      properties:
        CUSTOM_NUMBER_1:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupUint32Criteria'
      required:
      - CUSTOM_NUMBER_1
    CustomNumber2Filter:
      type: object
      title: CUSTOM_NUMBER_2
      additionalProperties: false
      properties:
        CUSTOM_NUMBER_2:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupUint32Criteria'
      required:
      - CUSTOM_NUMBER_2
    CustomNumber3Filter:
      type: object
      title: CUSTOM_NUMBER_3
      additionalProperties: false
      properties:
        CUSTOM_NUMBER_3:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupUint32Criteria'
      required:
      - CUSTOM_NUMBER_3
    CustomNumber4Filter:
      type: object
      title: CUSTOM_NUMBER_4
      additionalProperties: false
      properties:
        CUSTOM_NUMBER_4:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupUint32Criteria'
      required:
      - CUSTOM_NUMBER_4
    CustomerList:
      properties:
        ad_account_id:
          description: Associated ad account ID.
          example: '549756359984'
          title: ad_account_id
          type: string
        created_time:
          description: Creation time. Unix timestamp in seconds.
          example: 1452208622
          title: created_time
          type: number
        id:
          description: Customer list ID.
          example: '643'
          title: id
          type: string
        name:
          description: Customer list name.
          example: The Glengarry Glen Ross leads
          title: name
          type: string
        num_batches:
          description: Total number of list updates.  List creation counts as one
            batch. Each <a href="/docs/redoc/#operation/ads_v3_customer_list_add_handler_PUT">Append</a>
            or <a href="/docs/redoc/#operation/ads_v3_customer_list_remove_handler_PUT">Remove
            API</a> call counts as another. List creation via the Ads Manager UI could
            result in more than one batch since the UI breaks up large lists.
          example: 2
          title: num_batches
          type: number
        num_removed_user_records:
          description: Number of removed user records. In a <a href="/docs/redoc/#operation/ads_v3_customer_list_remove_handler_PUT">Remove
            API</a> call, this counter increases even if the user is not found in
            the list.
          example: 0
          title: num_removed_user_records
          type: number
        num_uploaded_user_records:
          description: Number of uploaded user records. In an <a href="/docs/redoc/#operation/ads_v3_customer_list_add_handler_PUT">Append
            API</a> call, this counter increases even if the uploaded user is already
            in the list.
          example: 11
          title: num_uploaded_user_records
          type: number
        status:
          description: Customer list status. TOO_SMALL - the list has less than 100
            Pinterest users.
          enum:
          - PROCESSING
          - READY
          - TOO_SMALL
          - UPLOADING
          example: PROCESSING
          title: status
          type: string
        type:
          description: Always "customerlist".
          example: customerlist
          title: type
          type: string
        updated_time:
          description: Last update time. Unix timestamp in seconds.
          example: 1461269616
          title: updated_time
          type: number
        exceptions:
          description: Customer list errors
          title: exceptions
          type: object
      title: CustomerList
      type: object
    CustomerListRequest:
      properties:
        name:
          description: Customer list name.
          example: The Glengarry Glen Ross leads
          title: name
          type: string
        records:
          description: Records list. Can be any combination of emails, MAIDs, or IDFAs.
            Emails must be lowercase and can be plain text or hashed using SHA1, SHA256,
            or MD5. MAIDs and IDFAs must be hashed with SHA1, SHA256, or MD5.
          example: email1@pinterest.com,email2@pinterest.com,..<more records>
          title: records
          type: string
        list_type:
          allOf:
          - $ref: '#/components/schemas/UserListType'
          default: EMAIL
          title: list_type
          type: string
      required:
      - name
      - records
      title: CustomerListCreate
      type: object
    CustomerListUpdateRequest:
      properties:
        records:
          description: Records list. Can be any combination of emails, MAIDs, or IDFAs.
            Emails must be lowercase and can be plain text or hashed using SHA1, SHA256,
            or MD5. MAIDs and IDFAs must be hashed with SHA1, SHA256, or MD5.
          example: email2@pinterest.com,email6@pinterest.com,
          title: records
          type: string
        operation_type:
          allOf:
          - $ref: '#/components/schemas/UserListOperationType'
          title: operation_type
          type: string
      required:
      - operation_type
      - records
      title: CustomerListUpdate
      type: object
    DataOutputFormat:
      type: string
      description: Format of generated report
      example: JSON
      enum:
      - JSON
      - CSV
    DataStatus:
      description: Metrics availablity, e.g., "READY".
      example: READY
      type: string
      enum:
      - PROCESSING
      - READY
      - ESTIMATE
      - BEFORE_BUSINESS_CREATED
      - BEFORE_DATA_RETENTION_PERIOD
      - BEFORE_PIN_DATA_RETENTION_PERIOD
      - BEFORE_METRIC_START_DATE
      - BEFORE_CORE_METRIC_START_DATE
      - BEFORE_PIN_FORMAT_METRIC_START_DATE
      - BEFORE_AUDIENCE_METRIC_START_DATE
      - BEFORE_AUDIENCE_MONTHLY_METRIC_START_DATE
      - BEFORE_VIDEO_METRIC_START_DATE
      - BEFORE_CONVERSION_METRIC_START_DATE
      - PURCHASERS_METRIC_SMALLER_THAN_THRESHOLD
      - IN_BAD_TAG_DATE
      - BEFORE_PUBLISHED_METRIC_START_DATE
      - BEFORE_ASSIST_METRIC_START_DATE
      - BEFORE_PIN_CREATED
      - BEFORE_ACCOUNT_CLAIMED
      - BEFORE_DEMOGRAPHIC_FILTERS_START_DATE
      - AUDIENCE_SEGMENT_SMALLER_THAN_THRESHOLD
      - AUDIENCE_TOTAL_SMALLER_THAN_THRESHOLD
      - BEFORE_PRODUCT_GROUP_FILTER_START_DATE
    DeleteMemberAccessResult:
      type: object
      description: The terminated asset access.
      properties:
        asset_id:
          type: string
          description: Unique identifier of the business asset.
          example: '549755885175'
          pattern: ^\d+$
        member_id:
          type: string
          description: Unique identifier of the business member.
          example: '140943737684417'
          pattern: ^\d+$
    DeleteMemberAccessResultsResponseArray:
      type: object
      properties:
        items:
          type: array
          description: List of member asset permissions that were deleted.
          items:
            $ref: '#/components/schemas/DeleteMemberAccessResult'
    DeletedMembersResponse:
      type: object
      description: An object with a list of members that were deleted.
      properties:
        deleted_members:
          type: array
          description: List of members whose business membership have been terminated.
          example:
          - '809944451643622187'
          - '383791336903426391'
          items:
            type: string
            pattern: ^\d+$
            example: '809944451643622187'
    DeletePartnersRequest:
      properties:
        partner_ids:
          items:
            description: A list of partner ids to be deleted
            example: '1234567890123'
            maxLength: 22
            pattern: ^\d+$
            type: string
          minItems: 1
          maxItems: 50
          type: array
        partner_type:
          allOf:
          - description: |-
              If partner_type=INTERNAL, the deleted relationship is the partnership
              relationship a partner has with you
              If partner_type=EXTERNAL, the deleted relationship is the partnership
              relationship you have with a partner
            nullable: true
            type: string
            example: INTERNAL
          - $ref: '#/components/schemas/BusinessRoleCheckMode'
          nullable: true
          type: string
      required:
      - partner_ids
      type: object
    DeletePartnersResponse:
      type: object
      description: An object with a list of partners that were deleted.
      properties:
        deleted_partners:
          type: array
          description: List of partners whose business partnership have been terminated.
          example:
          - '809944451643622187'
          - '383791336903426391'
          items:
            type: string
            pattern: ^\d+$
            example: '809944451643622187'
    DeliveryMetricsResponse:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
                description: Metric's name.
                example: AD_GROUP_ID
              category:
                enum:
                - ADS
                - ORGANIC
                description: Category name
                example: ADS
              definition:
                type: string
                description: How the metric is defined.
                example: Unique ID for your ad group
              display_name:
                type: string
                description: Display name, when available. If unavaible it will not
                  be returned. Matches how the metric is named in our native tools
                  like Pinterest Ads Manager.
                example: Ad group ID
    DetailedError:
      title: Detailed Error
      description: Used for including extra details to a base error
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
        details:
          type: object
      required:
      - code
      - message
      - details
    SummaryPin:
      description: Summarized pin information
      title: SummaryPin
      type: object
      properties:
        media:
          allOf:
          - $ref: '#/components/schemas/PinMedia'
          type: object
          readOnly: true
        alt_text:
          type: string
          nullable: true
          maxLength: 500
        link:
          type: string
          nullable: true
          example: https://www.pinterest.com/
          maxLength: 2048
        title:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
        id:
          type: string
    EnhancedMatchStatusType:
      description: The enhanced match status of the tag
      enum:
      - UNKNOWN
      - NOT_VALIDATED
      - VALIDATING_IN_PROGRESS
      - VALIDATION_COMPLETE
      - null
      example: VALIDATION_COMPLETE
      nullable: true
      title: EnhancedMatchStatusType
      type: string
    EntityStatus:
      type: string
      description: Entity status
      example: ACTIVE
      enum:
      - ACTIVE
      - PAUSED
      - ARCHIVED
      - DRAFT
      - DELETED_DRAFT
    Error:
      title: Error
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
      required:
      - code
      - message
    Exception:
      title: Generic exception class to be used within schemas
      type: object
      properties:
        code:
          type: integer
          example: 2
          description: Exception error code.
        message:
          type: string
          example: Advertiser not found.
          description: Exception message.
    FollowUserRequest:
      title: FollowUserRequest
      type: object
      properties:
        auto_follow:
          title: auto_follow
          type: boolean
          description: Whether this request comes as result of auto-follow after clicking
            on a link. Follow links can be used by partners on their site or in emails.
            Only selected partners can be followed this way. We verify that partner
            can be auto-followed.
          default: false
          example: false
    Gender:
      type: string
      enum:
      - FEMALE
      - MALE
      - UNISEX
    GenderFilter:
      type: object
      title: GENDER
      additionalProperties: false
      properties:
        GENDER:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleGenderCriteria'
      required:
      - GENDER
    MediaType:
      type: string
      enum:
      - IMAGE
      - VIDEO
    MediaTypeFilter:
      type: object
      title: MEDIA_TYPE
      additionalProperties: false
      properties:
        MEDIA_TYPE:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleMediaTypesCriteria'
      required:
      - MEDIA_TYPE
    GenderList:
      title: Gender
      type: array
      example:
      - female
      - unknown
      items:
        type: string
        enum:
        - female
        - male
        - unknown
    GetAudiencesOrderBy:
      type: string
      enum:
      - NONE
      - ID
      - SIZE
      - CREATION_DATE
      - UPDATED_TIME
      - NAME
      - STATUS
      - TYPE
      example: NAME
    GetBusinessAssetsResponse:
      type: object
      description: An object containing the permissions a business has on the asset.
      properties:
        asset_id:
          description: Unique identifier of a business asset.
          example: '549755885175'
          pattern: ^\d+$
          type: string
          maxLength: 20
          minLength: 1
        asset_type:
          $ref: '#/components/schemas/AssetTypeResponse'
        asset_group_info:
          nullable: true
          description: An object containing all the information specific to the provided
            asset group. This field will be populated only if asset_type equals 'ASSET_GROUP'.
          $ref: '#/components/schemas/AssetGroupBinding'
        catalog_info:
          nullable: true
          description: An object containing all the information specific to the provided
            catalog. This field will be populated only if asset_type equals 'CATALOG'.
          type: object
          properties:
            id:
              description: Catalog ID.
              example: '4836859046874'
              type: string
              pattern: ^\d+$
            name:
              type: string
              description: Catalog name
              example: Canada Catalog
            catalog_type:
              type: string
              description: Catalog type
              example: PRODUCT
    GetBusinessAssetTypeResponse:
      description: Type of asset.
      enum:
      - AD_ACCOUNT
      - PROFILE
      - ASSET_GROUP
      - CONVERSION_TAG
      - CATALOG
      example: AD_ACCOUNT
      type: string
    GetMMMReportResponse:
      properties:
        code:
          example: 0
          type: number
        data:
          title: GetMMMReportResponseData
          type: object
          properties:
            report_status:
              type: string
              enum:
              - DOES_NOT_EXIST
              - FINISHED
              - IN_PROGRESS
              - EXPIRED
              - FAILED
              - CANCELLED
            url:
              type: string
              nullable: true
            size:
              type: number
              nullable: true
        message:
          example: ok
          type: string
        status:
          example: success
          type: string
      type: object
    GetPartnerAssetsResponse:
      type: object
      description: An object containing the permissions a you/your business partner
        has on the asset.
      properties:
        asset_id:
          description: Unique identifier of a business asset.
          example: '549755885175'
          pattern: ^\d+$
          type: string
          maxLength: 20
          minLength: 1
        asset_type:
          $ref: '#/components/schemas/AssetTypeResponse'
        permissions:
          type: array
          description: The permissions you or your partner has on the asset. If partner_type=INTERNAL,
            the permission levels are for the access the partner has to your business
            asset.<br> If partner_type=EXTERNAL, the permission levels are for the
            access you have to the partner's business asset.
          example:
          - FINANCE_MANAGER
          - CATALOGS_MANAGER
          - AUDIENCE_MANAGER
          items:
            description: The permission level a user has on an asset.
            example: FINANCE_MANAGER
            type: string
        asset_group_info:
          nullable: true
          description: An object containing all the information specific to the provided
            asset group. This field will be populated only if asset_type equals 'ASSET_GROUP'.
          $ref: '#/components/schemas/AssetGroupBinding'
    GoogleProductCategory0Filter:
      type: object
      title: GOOGLE_PRODUCT_CATEGORY_0
      additionalProperties: false
      properties:
        GOOGLE_PRODUCT_CATEGORY_0:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - GOOGLE_PRODUCT_CATEGORY_0
    GoogleProductCategory1Filter:
      type: object
      title: GOOGLE_PRODUCT_CATEGORY_1
      additionalProperties: false
      properties:
        GOOGLE_PRODUCT_CATEGORY_1:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - GOOGLE_PRODUCT_CATEGORY_1
    GoogleProductCategory2Filter:
      type: object
      title: GOOGLE_PRODUCT_CATEGORY_2
      additionalProperties: false
      properties:
        GOOGLE_PRODUCT_CATEGORY_2:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - GOOGLE_PRODUCT_CATEGORY_2
    GoogleProductCategory3Filter:
      type: object
      title: GOOGLE_PRODUCT_CATEGORY_3
      additionalProperties: false
      properties:
        GOOGLE_PRODUCT_CATEGORY_3:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - GOOGLE_PRODUCT_CATEGORY_3
    GoogleProductCategory4Filter:
      type: object
      title: GOOGLE_PRODUCT_CATEGORY_4
      additionalProperties: false
      properties:
        GOOGLE_PRODUCT_CATEGORY_4:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - GOOGLE_PRODUCT_CATEGORY_4
    GoogleProductCategory5Filter:
      type: object
      title: GOOGLE_PRODUCT_CATEGORY_5
      additionalProperties: false
      properties:
        GOOGLE_PRODUCT_CATEGORY_5:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - GOOGLE_PRODUCT_CATEGORY_5
    GoogleProductCategory6Filter:
      type: object
      title: GOOGLE_PRODUCT_CATEGORY_6
      additionalProperties: false
      properties:
        GOOGLE_PRODUCT_CATEGORY_6:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - GOOGLE_PRODUCT_CATEGORY_6
    ProductGroupReferenceFilter:
      type: object
      title: PRODUCT_GROUP
      additionalProperties: false
      properties:
        PRODUCT_GROUP:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringCriteria'
      required:
      - PRODUCT_GROUP
    Granularity:
      type: string
      description: |-
        <p>Specifies the time interval at which analytics data is broken down. Determines how metrics are grouped within the requested date range.</p>
        <p><strong>Note:</strong> The `HOUR` enum no longer provides data for conversion metrics, but it still returns data for non-conversion metrics. All other enums are unchanged.</p>
      enum:
      - TOTAL
      - DAY
      - HOUR
      - WEEK
      - MONTH
    GridClickType:
      type: string
      description: Where a user is taken after clicking on an ad in grid. </p><strong>Note:</strong>  This
        parameter is read-only and is set to DIRECT_TO_DESTINATION by default for
        direct links supported ads.  grid_click_type values provided will be ignored.
      example: CLOSEUP
      nullable: true
      enum:
      - CLOSEUP
      - DIRECT_TO_DESTINATION
    HotelIdFilter:
      type: object
      title: HOTEL_ID
      additionalProperties: false
      properties:
        HOTEL_ID:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringCriteria'
      required:
      - HOTEL_ID
    CreativeAssetsIdFilter:
      type: object
      title: CREATIVE_ASSETS_ID
      additionalProperties: false
      properties:
        CREATIVE_ASSETS_ID:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringCriteria'
      required:
      - CREATIVE_ASSETS_ID
    HotelProcessingRecord:
      type: object
      description: Object describing an item processing record
      properties:
        hotel_id:
          description: The catalog hotel id in the merchant namespace
          example: DS0294-M
          type: string
        errors:
          description: |-
            Array with the validation errors for the item processing record.
            A non empty errors list causes the item processing to fail.
          items:
            $ref: '#/components/schemas/ItemValidationEvent'
          type: array
        warnings:
          description: Array with the validation warnings for the item processing
            record
          items:
            $ref: '#/components/schemas/ItemValidationEvent'
          type: array
        status:
          $ref: '#/components/schemas/ItemProcessingStatus'
    ImageDetails:
      type: object
      required:
      - height
      - url
      - width
      properties:
        height:
          type: integer
          nullable: true
        url:
          type: string
        width:
          type: integer
          nullable: true
      title: Image details containing the URL and dimensions.
    ImageMetadata:
      type: object
      properties:
        description:
          type: string
          nullable: true
        images:
          $ref: '#/components/schemas/ImageSize'
        item_type:
          type: string
        link:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
      title: Image metadata containing the description, images, item type, link, and
        title.
    ImageSize:
      type: object
      properties:
        150x150:
          $ref: '#/components/schemas/ImageDetails'
        400x300:
          $ref: '#/components/schemas/ImageDetails'
        600x:
          $ref: '#/components/schemas/ImageDetails'
        1200x:
          $ref: '#/components/schemas/ImageDetails'
      example:
        150x150:
          width: 150
          height: 150
          url: https://i.pinimg.com/150x150/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg
        400x300:
          width: 400
          height: 300
          url: https://i.pinimg.com/400x300/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg
        600x:
          width: 600
          height: 600
          url: https://i.pinimg.com/600x/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg
        1200x:
          width: 1200
          height: 1200
          url: https://i.pinimg.com/1200x/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg
    IntegrationLog:
      type: object
      additionalProperties: false
      description: Schema for log sent from an integration application.
      required:
      - client_timestamp
      - event_type
      - log_level
      properties:
        client_timestamp:
          type: integer
          description: Timestamp in milliseconds of when the log was executed at the
            client.
        event_type:
          type: string
          enum:
          - APP
          - API
          description: Log event type
        log_level:
          type: string
          enum:
          - INFO
          - WARN
          - ERROR
          description: Log level type
        external_business_id:
          type: string
          maxLength: 2048
          nullable: true
        advertiser_id:
          type: string
          maxLength: 128
          nullable: true
        merchant_id:
          type: string
          maxLength: 128
          nullable: true
        tag_id:
          type: string
          maxLength: 128
          nullable: true
        feed_profile_id:
          type: string
          maxLength: 128
          nullable: true
        message:
          type: string
          description: Explanation of the event that occured.
          maxLength: 8192
        app_version_number:
          type: string
          description: Version number of the integration application.
          maxLength: 20
        platform_version_number:
          type: string
          description: Version number of the platform the integration application
            is running on.
          maxLength: 20
        error:
          $ref: '#/components/schemas/IntegrationLogClientError'
        request:
          $ref: '#/components/schemas/IntegrationLogClientRequest'
    IntegrationLogClientError:
      type: object
      additionalProperties: false
      description: System error details included in the log sent by the client.
      properties:
        cause:
          type: string
          description: Original cause of the error.
          maxLength: 512
        column_number:
          type: integer
          description: Column number in the line of the file that raised the error.
        file_name:
          type: string
          description: Filename where the error happened.
          maxLength: 256
        line_number:
          type: integer
          description: Line number where the error happened.
        message:
          type: string
          description: Human-readable description of the error.
          maxLength: 8192
        message_detail:
          type: string
          description: More detail about the message.
          maxLength: 1024
        name:
          type: string
          description: Filename where the error happened.
          maxLength: 256
        number:
          type: integer
          description: Integer that specifies the error code.
        stack_trace:
          type: string
          description: Stack trace of where the error happened.
    IntegrationLogClientRequest:
      type: object
      additionalProperties: false
      description: HTTP request details included in the log sent by the client.
      required:
      - method
      - host
      - path
      properties:
        method:
          type: string
          enum:
          - GET
          - HEAD
          - POST
          - PUT
          - DELETE
          - CONNECT
          - OPTIONS
          - TRACE
          - PATCH
        host:
          type: string
          description: HTTP request host from host header.
        path:
          type: string
          description: HTTP request path.
        request_headers:
          type: object
          description: HTTP request headers as key-value pairs.
          additionalProperties:
            type: string
        response_headers:
          type: object
          description: HTTP response headers as key-value pairs.
          additionalProperties:
            type: string
        response_status_code:
          type: integer
    IntegrationLogsInvalidLogResponse:
      description: Schema describing the response when a log has invalid fields.
      type: object
      properties:
        rejected_logs:
          type: array
          items:
            type: object
            properties:
              log_index:
                type: integer
                description: Index of the log in the batch.
              field:
                type: string
                description: The field name containing an invalid value.
              value:
                type: string
                description: The value that is invalid.
              reason:
                type: string
                description: The reason the value is invalid.
            required:
            - field
            - value
            - reason
    IntegrationLogsRequest:
      type: object
      additionalProperties: false
      description: Batch of logs sent from an integration application.
      required:
      - logs
      properties:
        logs:
          type: array
          minItems: 1
          maxItems: 250
          items:
            $ref: '#/components/schemas/IntegrationLog'
    IntegrationLogsSuccessResponse:
      description: Response when logs are successfully processed.
      type: object
      properties:
        message:
          type: string
    IntegrationMetadata:
      title: integration
      description: Integration metadata
      type: object
      properties:
        id:
          type: string
          pattern: ^\d+$
        external_business_id:
          type: string
        connected_merchant_id:
          type: string
        connected_user_id:
          type: string
          readOnly: true
        connected_advertiser_id:
          type: string
          readOnly: true
        connected_lba_id:
          type: string
        connected_tag_id:
          type: string
        partner_access_token_expiry:
          type: number
        partner_refresh_token_expiry:
          type: number
        scopes:
          type: string
        created_timestamp:
          type: number
        updated_timestamp:
          type: number
        additional_id_1:
          type: string
        partner_metadata:
          type: string
      example:
        id: '7329167449607351372'
        external_business_id: '1238401984'
        connected_merchant_id: '1445572885401'
        connected_user_id: '871939315263957401'
        connected_advertiser_id: '549764738871'
        connected_lba_id: '871939315263957402'
        connected_tag_id: '2412141155151'
        partner_access_token_expiry: 1621350033000
        partner_refresh_token_expiry: 1621350033000
        scopes: accounts:read
        created_timestamp: 1621350033000
        updated_timestamp: 1621350033000
        additional_id_1: '128464'
        partner_metadata: ''
    IntegrationRequest:
      type: object
      description: Schema used for creating the integration metadata.
      properties:
        external_business_id:
          type: string
          description: External business ID for the integration.
        connected_merchant_id:
          type: string
        connected_advertiser_id:
          type: string
        connected_lba_id:
          type: string
        connected_tag_id:
          type: string
        partner_access_token:
          type: string
        partner_refresh_token:
          type: string
        partner_primary_email:
          type: string
        partner_access_token_expiry:
          type: integer
        partner_refresh_token_expiry:
          type: integer
        scopes:
          type: string
        additional_id_1:
          type: string
        partner_metadata:
          type: string
    IntegrationRequestPatch:
      type: object
      description: Schema used for updating the integration metadata.
      properties:
        connected_merchant_id:
          type: string
        connected_advertiser_id:
          type: string
        connected_lba_id:
          type: string
        connected_tag_id:
          type: string
        partner_access_token:
          type: string
        partner_refresh_token:
          type: string
        partner_primary_email:
          type: string
        partner_access_token_expiry:
          type: number
        partner_refresh_token_expiry:
          type: number
        scopes:
          type: string
        additional_id_1:
          type: string
        partner_metadata:
          type: string
    IntegrationRecord:
      title: Integration record
      description: Integration record
      type: object
      properties:
        id:
          type: string
          pattern: ^\d+$
        external_business_id:
          type: string
          nullable: true
        connected_merchant_id:
          type: string
          nullable: true
        connected_user_id:
          type: string
          readOnly: true
        connected_advertiser_id:
          type: string
          readOnly: true
          nullable: true
        connected_lba_id:
          type: string
          nullable: true
        connected_tag_id:
          type: string
          nullable: true
        partner_access_token:
          type: string
          nullable: true
        partner_refresh_token:
          type: string
          nullable: true
        partner_primary_email:
          type: string
          nullable: true
        partner_access_token_expiry:
          type: integer
          nullable: true
        partner_refresh_token_expiry:
          type: integer
          nullable: true
        scopes:
          type: string
          nullable: true
        partner_metadata:
          type: string
          nullable: true
        additional_id_1:
          type: string
          nullable: true
        created_time:
          type: integer
        updated_time:
          type: integer
      example:
        id: '7329123456789012345'
        external_business_id: '1234567890'
        connected_merchant_id: '1234567890123'
        connected_user_id: '123456789012345678'
        connected_advertiser_id: '123456789012'
        connected_lba_id: '871234567890123456'
        connected_tag_id: '2412345678901'
        partner_access_token: ABCLUOJS5XDMWDE
        partner_refresh_token: ABCLUOJS5XDMWDE
        partner_primary_email: partner@server.com
        partner_access_token_expiry: 1621350033000
        partner_refresh_token_expiry: 1621350033000
        scopes: accounts:read
        partner_metadata: ''
        additional_id_1: '123456'
        created_time: 1621350033000
        updated_time: 1621350033000
    Interest:
      title: Interest
      type: object
      properties:
        canonical_url:
          type: string
        id:
          type: string
          pattern: ^\d+$
          example: '903972677830'
        key:
          type: string
          example: man cave
        name:
          type: string
          example: Man cave
    InviteAssetsSummary:
      type: object
      description: Ad accounts and profiles the member/partner will be granted access
        to with this invite/request.
      nullable: true
      properties:
        ad_accounts:
          type: array
          description: List of ad account IDs and respective permission levels that
            will be assigned.
          items:
            type: object
            properties:
              id:
                type: string
                description: Unique identifier of a business ad account.
                example: '549755885175'
                pattern: ^\d+$
              permissions:
                $ref: '#/components/schemas/PermissionsResponse'
        profiles:
          type: array
          description: List of profile IDs and respective permission levels that will
            be assigned.
          items:
            type: object
            properties:
              id:
                type: string
                description: Unique identifier of a business profile.
                example: '383791336903426391'
                pattern: ^\d+$
              permissions:
                $ref: '#/components/schemas/PermissionsResponse'
    InviteExceptionResponse:
      type: object
      description: An exception object if there is an error performing the action.
        Will only be provided if there is an error.
      nullable: true
      properties:
        invite_or_request_id:
          type: string
          description: Unique identifier of the invite/request.
          example: '383791336903426391'
          pattern: ^\d+$
          nullable: true
        code:
          type: integer
          description: Error code associated with the error in performing the action
            on the invite/request.
          example: 403
        message:
          type: string
          description: Error message associated with the error in performing the action
            on the invite/request.
          example: You hit the maximum number of pending invites allowed.
        users_or_partner_ids:
          type: array
          description: A list of users' usernames or emails OR a list of partner ids
            that caused the error.
          nullable: true
          example:
          - businessMember0101
          - business+member@business.com
          items:
            type: string
            description: A user's username or email OR a partner id that caused the
              error.
    InviteBusinessRoleBinding:
      type: object
      description: An invite object if the invite/request was successfully updated.
        Will only be provided if the an invite/request is successfully updated.
      nullable: true
      allOf:
      - $ref: '#/components/schemas/BaseInviteDataResponse'
      properties:
        created_by_business_id:
          type: string
          description: Unique identifier for the business that created the invite/request.
          example: '1234567890123'
        created_by_user_id:
          type: string
          description: Unique identifier for the user that created the invite/request.
          example: '1234567890123'
        user:
          type: object
          description: Metadata for the user that updated the invite/request.
          allOf:
          - $ref: '#/components/schemas/BusinessAccessUserSummary'
    InviteResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/BaseInviteDataResponse'
      properties:
        assets_summary:
          $ref: '#/components/schemas/InviteAssetsSummary'
        business_roles:
          description: The access level a user would be granted on the business if
            the invite/request is accepted. This can be EMPLOYEE, BIZ_ADMIN, or PARTNER.
          type: array
          example:
          - BIZ_ADMIN
          items:
            $ref: '#/components/schemas/BusinessRoleResponse'
        created_by_business:
          type: object
          description: Metadata for the business that created the invite/request.
          nullable: true
          allOf:
          - $ref: '#/components/schemas/BusinessAccessUserSummary'
        created_by_user:
          type: object
          description: Metadata for the user that created the invite/request.
          nullable: true
          allOf:
          - $ref: '#/components/schemas/BusinessAccessUserSummary'
        created_time:
          type: integer
          description: The time the invite/request was created. Returned in milliseconds.
          example: 1646767577816
    InviteStatus:
      description: The current status of the invite.
      enum:
      - PENDING
      - ACCEPTED
      - DECLINED
      - CANCELLED
      - EXPIRED
      example: PENDING
      type: string
    InviteType:
      description: The type of invite. <br>'MEMBER_INVITE' is to invite a member to
        access your business assets. <br>'PARTNER INVITE' is to invite a partner to
        access your business assets. <br>'PARTNER_REQUEST' is to request access a
        partner's business assets.
      example: MEMBER_INVITE
      enum:
      - MEMBER_INVITE
      - PARTNER_INVITE
      - PARTNER_REQUEST
      type: string
    AssetGroupBinding:
      type: object
      properties:
        id:
          description: Asset Group ID.
          example: '666791336903426391'
          type: string
          pattern: ^\d+$
        asset_group_name:
          type: string
          description: Asset Group name
          example: Canada Ad Accounts
          nullable: true
        asset_group_description:
          type: string
          description: Asset group description
          example: Asset group that has ad accounts used in Canada
          nullable: true
        asset_group_types:
          type: array
          description: Asset group types
          example:
          - LOCATION_OR_LANGUAGE
          items:
            description: The types of the asset group.
            example: LOCATION_OR_LANGUAGE
            type: string
        ad_accounts_ids:
          description: A list of ad account IDs under the asset group
          example:
          - '549755885175'
          type: array
          nullable: true
          items:
            description: The ID of an ad account in the asset group.
            example: '549755885175'
            type: string
            pattern: ^\d+$
        profiles_ids:
          description: A list of profile IDs under asset group
          example:
          - '630433785246278264'
          type: array
          nullable: true
          items:
            description: The ID of a profile in an asset group.
            example: '630433785246278264'
            type: string
            pattern: ^\d+$
        catalogs_ids:
          description: A list of catalog IDs under asset group
          example:
          - '4836859046874'
          type: array
          nullable: true
          items:
            description: The ID of a catalog in an asset group.
            example: '4836859046874'
            type: string
            pattern: ^\d+$
        created_time:
          description: The creation time of the asset group
          example: 1646767577816
          nullable: true
          type: integer
        updated_time:
          description: The last update time of the asset group
          example: 1646767577816
          nullable: true
          type: integer
        owner:
          type: object
          allOf:
          - $ref: '#/components/schemas/BusinessAccessUserSummary'
          description: The data of the business that owns the asset group.
          nullable: true
        created_by:
          type: object
          allOf:
          - $ref: '#/components/schemas/BusinessAccessUserSummary'
          description: The data of the user that created the asset group.
          nullable: true
    AssetGroupType:
      description: Asset group type
      enum:
      - BRAND
      - LOCATION_OR_LANGUAGE
      - PRODUCT_LINE
      - OTHER
      example: BRAND
      type: string
    AssetGroupTypes:
      description: 'Asset Group Types. Note: The asset group types are used for user
        reference and categorization purposes only and do not impact the functionality
        of the asset group.'
      example:
      - BRAND
      - LOCATION_OR_LANGUAGE
      - PRODUCT_LINE
      - OTHER
      type: array
      items:
        $ref: '#/components/schemas/AssetGroupType'
    ItemAttributes:
      type: object
      allOf:
      - type: object
        properties:
          additional_image_link:
            description: |-
              <p><= 2000 characters</p>
              <p>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://.</p>
            example:
            - https://scene.example.com/image/image_v2.jpg
            - https://scene.example.com/image/image_v3.jpg
            type: array
            nullable: true
            items:
              type: string
          image_link:
            description: |-
              <p><= 2000 characters</p>
              <p>The link 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://.</p>
            example:
            - https://scene.example.com/image/image.jpg
            type: array
            minItems: 1
            items:
              type: string
          video_link:
            description: |-
              <p><= 2,000 characters</p>
              <p>Hosted link to the product video.</p>
              <p>File types for linked videos must be .mp4, .mov or .m4v.</p>
              <p>File size cannot exceed 2GB.</p>
            example: https://www.example.com/cat/womens-clothing/denim-shirt-0294.mp4
            type: string
            nullable: true
      - $ref: '#/components/schemas/UpdatableItemAttributes'
    ItemAttributesRequest:
      type: object
      allOf:
      - type: object
        properties:
          additional_image_link:
            description: |-
              <p><= 2000 characters</p>
              <p>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://.</p>
            example:
            - https://scene.example.com/image/image_v2.jpg
            - https://scene.example.com/image/image_v3.jpg
            type: array
            nullable: true
            items:
              type: string
          image_link:
            description: |-
              <p><= 2000 characters</p>
              <p>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://.</p>
            example:
            - https://scene.example.com/image/image.jpg
            oneOf:
            - description: The list of links to the main product images
              type: array
              minItems: 1
              items:
                type: string
            - description: The main product image link.
              type: string
              nullable: false
          save_pin_disabled:
            description: 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.
            example: true
            type: boolean
            default: false
          video_link:
            description: |-
              <p><= 2,000 characters</p>
              <p>Hosted link to the product video.</p>
              <p>File types for linked videos must be .mp4, .mov or .m4v.</p>
              <p>File size cannot exceed 2GB.</p>
            example: https://www.example.com/cat/womens-clothing/denim-shirt-0294.mp4
            type: string
            nullable: true
      - $ref: '#/components/schemas/UpdatableItemAttributes'
      - type: object
        properties:
          ad_image_0_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_1_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_2_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_3_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_4_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_5_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_6_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_7_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_8_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_9_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_10_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_11_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_12_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_13_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_14_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_15_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_16_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_17_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_18_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_19_link:
            type: string
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 2000 characters</p>
              <p>Ad image link that supplements main image for shopping campaigns.</p>
              <p>Image format:</p>
              <ul>
                <li>Pixel size at least 75 x 75</li>
              </ul>
              <p>Link guidelines:</p>
              <ul>
                <li>Include extension in file name</li>
                <li>Do not include template or placeholder images in link</li>
                <li>Make URL accessible to Pinterest user-agent</li>
                <li>Must start with http:// or https://</li>
              </ul>
            example: https://www.example.com/image/image_v2.jpg
            nullable: true
          ad_image_0_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_1_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_2_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_3_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_4_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_5_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_6_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_7_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_8_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_9_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_10_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_11_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_12_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_13_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_14_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_15_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_16_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_17_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_18_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
          ad_image_19_tag:
            description: |-
              <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
              <p><= 511 characters</p>
              <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
            example: black friday
            type: string
            nullable: true
    ItemBatchRecord:
      type: object
      description: Object describing an item batch record
      oneOf:
      - $ref: '#/components/schemas/ItemCreateBatchRecord'
      - $ref: '#/components/schemas/ItemDeleteDiscontinuedBatchRecord'
      - $ref: '#/components/schemas/ItemUpdateBatchRecord'
      - $ref: '#/components/schemas/ItemUpsertBatchRecord'
      - $ref: '#/components/schemas/ItemDeleteBatchRecord'
    ItemCreateBatchRecord:
      type: object
      description: Object describing an item batch record to create items
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
        attributes:
          $ref: '#/components/schemas/ItemAttributesRequest'
    ItemDeleteBatchRecord:
      type: object
      description: Object describing an item batch record to delete items
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
    ItemDeleteDiscontinuedBatchRecord:
      type: object
      description: Object describing an item batch record to discontinue items
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
    ItemGroupIdFilter:
      type: object
      title: ITEM_GROUP_ID
      additionalProperties: false
      properties:
        ITEM_GROUP_ID:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringCriteria'
      required:
      - ITEM_GROUP_ID
    ItemIdFilter:
      type: object
      title: ITEM_ID
      additionalProperties: false
      properties:
        ITEM_ID:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringCriteria'
      required:
      - ITEM_ID
    TitleKeywordsFilter:
      type: object
      title: TITLE_KEYWORDS
      additionalProperties: false
      properties:
        TITLE_KEYWORDS:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringCriteria'
      required:
      - TITLE_KEYWORDS
    ItemProcessingRecord:
      type: object
      description: Object describing an item processing record
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
        errors:
          description: |-
            Array with the validation errors for the item processing record.
            A non empty errors list causes the item processing to fail.
          items:
            $ref: '#/components/schemas/ItemValidationEvent'
          type: array
        warnings:
          description: Array with the validation warnings for the item processing
            record
          items:
            $ref: '#/components/schemas/ItemValidationEvent'
          type: array
        status:
          $ref: '#/components/schemas/ItemProcessingStatus'
    ItemProcessingStatus:
      description: The status of the item processing record
      example: SUCCESS
      type: string
      enum:
      - SUCCESS
      - FAILURE
      - PROCESSING
    ItemResponse:
      type: object
      description: Object describing an item record
      anyOf:
      - type: object
        properties:
          catalog_type:
            $ref: '#/components/schemas/CatalogsType'
        required:
        - catalog_type
        oneOf:
        - $ref: '#/components/schemas/CatalogsRetailItemResponse'
        - $ref: '#/components/schemas/CatalogsHotelItemResponse'
        - $ref: '#/components/schemas/CatalogsCreativeAssetsItemResponse'
        discriminator:
          propertyName: catalog_type
          mapping:
            RETAIL: '#/components/schemas/CatalogsRetailItemResponse'
            HOTEL: '#/components/schemas/CatalogsHotelItemResponse'
            CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsItemResponse'
      - type: object
        properties:
          catalog_type:
            $ref: '#/components/schemas/CatalogsType'
        required:
        - catalog_type
        oneOf:
        - $ref: '#/components/schemas/CatalogsRetailItemErrorResponse'
        - $ref: '#/components/schemas/CatalogsHotelItemErrorResponse'
        - $ref: '#/components/schemas/CatalogsCreativeAssetsItemErrorResponse'
        discriminator:
          propertyName: catalog_type
          mapping:
            RETAIL: '#/components/schemas/CatalogsRetailItemErrorResponse'
            HOTEL: '#/components/schemas/CatalogsHotelItemErrorResponse'
            CREATIVE_ASSETS: '#/components/schemas/CatalogsCreativeAssetsItemErrorResponse'
    ItemUpdateBatchRecord:
      type: object
      description: Object describing an item batch record to update items
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
        attributes:
          $ref: '#/components/schemas/UpdatableItemAttributes'
        update_mask:
          description: 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.
          example:
          - ad_link
          - adult
          - age_group
          - availability
          - average_review_rating
          - brand
          - checkout_enabled
          - color
          - condition
          - custom_label_0
          - custom_label_1
          - custom_label_2
          - custom_label_3
          - custom_label_4
          - description
          - free_shipping_label
          - free_shipping_limit
          - gender
          - google_product_category
          - gtin
          - item_group_id
          - last_updated_time
          - link
          - material
          - min_ad_price
          - mpn
          - number_of_ratings
          - number_of_reviews
          - pattern
          - price
          - product_type
          - sale_price
          - shipping
          - shipping_height
          - shipping_weight
          - shipping_width
          - size
          - size_system
          - size_type
          - tax
          - title
          - variant_names
          - variant_values
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/UpdateMaskFieldType'
    ItemUpsertBatchRecord:
      type: object
      description: Object describing an item batch record to upsert items
      properties:
        item_id:
          description: The catalog item id in the merchant namespace
          example: DS0294-M
          type: string
        attributes:
          $ref: '#/components/schemas/ItemAttributesRequest'
    ItemValidationEvent:
      type: object
      description: Object describing an item validation event
      properties:
        attribute:
          description: The attribute that the item validation event references
          example: title
          type: string
        code:
          description: The event code that the item validation event references
          example: 106
          type: integer
        message:
          description: Title message describing the item validation event
          example: Title is missing from product metadata.
          type: string
    Keyword:
      type: object
      allOf:
      - $ref: '#/components/schemas/KeywordsCommon'
      - type: object
        properties:
          archived:
            type: boolean
            example: false
          id:
            description: Keyword ID .
            example: '383791336903426391'
            pattern: ^\d+$
            title: id
            type: string
          parent_id:
            description: Keyword parent entity ID (advertiser, campaign, ad group).
            example: '383791336903426391'
            pattern: ^\d+$
            title: parent_id
            type: string
          parent_type:
            type: string
            description: Parent entity type
            example: campaign
          type:
            type: string
            description: Always keyword
            example: keyword
    KeywordError:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/Keyword'
        error_messages:
          type: array
          items:
            type: string
    KeywordList:
      title: Keywords
      type: array
      example:
      - recipes
      - dessert
      items:
        type: string
        minLength: 1
        maxLength: 100
      minItems: 1
      maxItems: 50
    KeywordMetrics:
      description: Keyword metrics JSON
      title: KeywordMetrics
      type: object
      properties:
        keyword_query_volume:
          example: 5M+
          title: keyword_query_volume
          description: Keyword's search frequency. This value is based on keyword
            frequency in pepsi client response
          type: string
    KeywordMetricsResponse:
      title: KeywordMetricsResponse
      type: object
      properties:
        keyword:
          description: Keyword name, e.g., "keyword":"fashion outfits"
          example: animals
          title: keyword
          type: string
        metrics:
          $ref: '#/components/schemas/KeywordMetrics'
    KeywordUpdate:
      title: KeywordUpdate
      type: object
      properties:
        id:
          type: string
          description: Keyword ID.
          example: '2886364308355'
          pattern: ^\d+$
          title: id
        archived:
          type: boolean
          description: Is keyword archived?
          example: false
          title: archived
        bid:
          type: integer
          description: </p><strong>Note:</strong> bid field has been deprecated. Input
            will not be set and field will return null. Keyword custom bid in microcurrency
            - null if inherited from parent ad group.
          example: null
          nullable: true
          title: bid
      required:
      - id
    KeywordUpdateBody:
      type: object
      properties:
        keywords:
          description: 'Keywords to update. Object array. Each object has 2 possible
            fields:<br>1. "id": (required) keyword ID<br>2. "archived": boolean. Should
            keyword be archived?<br>For example: [{"id":"2886610576653", "archived":
            false}, {"id":"2886610576654",  "archived": true}, ...]'
          type: array
          items:
            $ref: '#/components/schemas/KeywordUpdate'
          title: keywords
      required:
      - keywords
    KeywordsCommon:
      type: object
      properties:
        bid:
          type: integer
          description: </p><strong>Note:</strong> bid field has been deprecated. Input
            will not be set and field will return null. Keyword custom bid in microcurrency
            - null if inherited from parent ad group.
          example: null
          nullable: true
        match_type:
          $ref: '#/components/schemas/MatchTypeResponse'
        value:
          type: string
          description: Keyword value (120 chars max).
      required:
      - match_type
      - value
    KeywordsMetricsArrayResponse:
      type: object
      title: KeywordMetricsArrayResponse
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/KeywordMetricsResponse'
    KeywordsRequest:
      type: object
      properties:
        keywords:
          type: array
          description: Keyword JSON array. Each array element has 3 fields
          items:
            $ref: '#/components/schemas/KeywordsCommon'
        parent_id:
          description: Keyword parent entity ID (advertiser, campaign, ad group).
          example: '383791336903426391'
          pattern: ^((AG)|C)?\d+$
          title: parent_id
          type: string
      required:
      - keywords
      - parent_id
    KeywordsResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/KeywordError'
        keywords:
          type: array
          items:
            $ref: '#/components/schemas/Keyword'
    L1InterestList:
      title: Interest
      type: array
      example:
      - beauty
      - womens_fashion
      items:
        type: string
        enum:
        - animals
        - architecture
        - art
        - beauty
        - childrens_fashion
        - design
        - diy_and_crafts
        - education
        - electronics
        - entertainment
        - event_planning
        - finance
        - food_and_drinks
        - gardening
        - health
        - home_decor
        - mens_fashion
        - parenting
        - quotes
        - sport
        - travel
        - vehicles
        - wedding
        - womens_fashion
    Label:
      type: object
      properties:
        id:
          description: Label ID.
          example: '1106385754497'
          title: id
          type: string
        value:
          type: string
          maxLength: 100
          description: Label name.
        label_type:
          type: string
          description: Label type.
          example: BRAND
        parent_id:
          description: Label parent entity ID.
          example: '626753052072'
          title: parent_id
          type: string
        parent_type:
          type: string
          description: Label parent entity type.
          example: CAMPAIGN
        status:
          type: string
          description: Label status.
          example: ACTIVE
    LabelCreateRequest:
      title: LabelCreateRequest
      type: object
      properties:
        labels:
          description: Labels that you are applying to the campaign.
          type: array
          items:
            type: object
            properties:
              value:
                type: string
                maxLength: 100
                description: Label name. 100-character limit.
              label_type:
                $ref: '#/components/schemas/LabelType'
            required:
            - value
            - label_type
        parent_id:
          description: Unique identifier of the asset you are labelling. Currently,
            you can only label campaigns.
          example: '626753052072'
          pattern: ^\d+$
          title: parent_id
          type: string
      required:
      - labels
      - parent_id
    LabelError:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/Label'
        error_messages:
          type: array
          items:
            type: string
    LabelParentType:
      type: string
      description: Label parent entity type.
      enum:
      - CAMPAIGN
      example: CAMPAIGN
    LabelsResponse:
      type: object
      properties:
        errors:
          type: array
          description: Labels that were not successfully applied.
          items:
            $ref: '#/components/schemas/LabelError'
        labels:
          type: array
          items:
            $ref: '#/components/schemas/Label'
    LabelStatus:
      type: string
      description: The new status you want to give the label, either `ACTIVE` (in
        use) or no longer in use (`ARCHIVED`).
      enum:
      - ACTIVE
      - ARCHIVED
      example: ACTIVE
    LabelType:
      type: string
      description: Category for the labeled items. You can apply one BRAND label to
        a campaign. You can apply 30 CUSTOM labels to a campaign.
      enum:
      - BRAND
      - CUSTOM
      example: BRAND
    LabelUpdateRequest:
      title: LabelUpdateRequest
      type: object
      properties:
        labels:
          description: Labels that you are applying to the campaign.
          type: array
          items:
            type: object
            properties:
              id:
                description: Label ID.
                example: '1106385754497'
                title: id
                type: string
              value:
                type: string
                maxLength: 100
                description: Label name. 100-character limit.
              status:
                $ref: '#/components/schemas/LabelStatus'
            required:
            - id
      required:
      - labels
    Language:
      type: string
      description: Language code, which is among the official ISO 639-1 language list.
      example: EN
      enum:
      - 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
    LeadFormCommon:
      type: object
      description: Creation fields
      properties:
        name:
          description: Internal name of the lead form.
          example: Lead Form 3/14/2023
          type: string
          nullable: true
        privacy_policy_link:
          description: A link to the advertiser's privacy policy. This will be included
            in the lead form's disclosure language.
          example: https://www.advertisername.com/privacy-policy
          type: string
          nullable: true
        has_accepted_terms:
          description: |-
            Whether the advertiser has accepted Pinterest's terms of service for creating a lead ad.

            By sending us TRUE for this parameter, you agree that (i) you will use any personal information received in
            compliance with the privacy policy you share with Pinterest, and (ii) you will comply with Pinterest's <a href="https://policy.pinterest.com/en/lead-ad-terms">Lead Ad Terms</a>. As a reminder, all advertising on Pinterest is subject to the <a href="https://business.pinterest.com/en/pinterest-advertising-services-agreement/">Pinterest Advertising Services Agreement</a> or an equivalent agreement as set forth on an IO
          example: false
          type: boolean
        completion_message:
          description: A message for people who complete the form to let them know
            what happens next.
          example: Thank you for submitting. We will contact you soon.
          type: string
          nullable: true
        status:
          $ref: '#/components/schemas/LeadFormStatus'
        disclosure_language:
          description: Additional disclosure language to be included in the lead form.
          example: By entering your personal information, you agree that your data
            will be collected and used.
          type: string
          nullable: true
        questions:
          description: List of questions to be displayed on the lead form.
          example:
          - question_type: CUSTOM
            custom_question_field_type: CHECKBOX
            custom_question_label: What is your favorite animal?
            custom_question_options:
            - Dog
            - Cat
            - Bird
            - Turtle
          type: array
          minItems: 0
          maxItems: 10
          items:
            $ref: '#/components/schemas/LeadFormQuestion'
        policy_links:
          description: List of additional policy links to be displayed on the lead
            form.
          example:
          - label: Copyright
            link: https://policy.pinterest.com/en/copyright
          type: array
          minItems: 0
          maxItems: 3
          items:
            type: object
            properties:
              label:
                description: Policy label for an additional policy link.
                nullable: false
                type: string
              link:
                description: Policy link for an additional policy link.
                nullable: false
                type: string
    LeadFormQuestion:
      type: object
      properties:
        question_type:
          $ref: '#/components/schemas/LeadFormQuestionType'
        custom_question_field_type:
          $ref: '#/components/schemas/LeadFormQuestionFieldType'
        custom_question_label:
          description: Question label for a custom question.
          nullable: true
          type: string
        custom_question_options:
          description: Question options for a custom question.
          nullable: true
          type: array
          minItems: 0
          maxItems: 5
          items:
            type: string
    LeadFormQuestionFieldType:
      type: string
      description: Lead form question field type
      example: RADIO_LIST
      nullable: true
      enum:
      - TEXT_FIELD
      - TEXT_AREA
      - RADIO_LIST
      - CHECKBOX
      - null
    LeadFormQuestionType:
      type: string
      description: Lead form question type
      example: FIRST_NAME
      enum:
      - CUSTOM
      - FULL_NAME
      - FIRST_NAME
      - LAST_NAME
      - EMAIL
      - PHONE_NUMBER
      - ZIP_CODE
      - GENDER
      - CITY
      - COUNTRY
      - STATE_PROVINCE
      - ADDRESS
      - DATE_OF_BIRTH
      - AGE
    LeadFormTestRequest:
      title: LeadFormTestRequest
      description: Request to create test data for lead data test API.
      type: object
      properties:
        answers:
          description: Test lead answers. Should follow the creation order.
          type: array
          items:
            type: string
          example:
          - John
          - Doe
          - abc@email.com
          - '987654321'
      required:
      - answers
    LeadFormTestResponse:
      title: LeadFormTestResponse
      type: object
      description: Response for lead data test API.
      properties:
        subscription_id:
          description: Subscription ID.
          example: '8078432025948590686'
          type: string
          pattern: ^\d+$
    LeadFormResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/LeadFormCommon'
      - type: object
        properties:
          id:
            description: The ID of this lead form
            example: '7765300871171'
            type: string
            pattern: ^\d+$
          ad_account_id:
            description: The Ad Account ID that this lead form belongs to.
            example: '549755885175'
            type: string
            pattern: ^\d+$
          created_time:
            description: Lead form creation time. Unix timestamp in seconds.
            example: 1451431341
            type: integer
          updated_time:
            description: Last update time. Unix timestamp in seconds.
            example: 1451431341
            type: integer
    LeadFormStatus:
      type: string
      description: Status of the lead form
      example: DRAFT
      enum:
      - DRAFT
      - ACTIVE
    LeadFormArrayResponse:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              data:
                $ref: '#/components/schemas/LeadFormResponse'
              exceptions:
                type: array
                items:
                  $ref: '#/components/schemas/Exception'
    LeadFormCreateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/LeadFormCommon'
      - required:
        - name
        - questions
        - privacy_policy_link
        - has_accepted_terms
        - completion_message
    LeadFormUpdateRequest:
      type: object
      allOf:
      - type: object
      - $ref: '#/components/schemas/LeadFormCommon'
      - required:
        - id
        properties:
          id:
            title: id
            description: The ID of this lead form to be updated
            type: string
            example: '7765300871171'
            pattern: ^\d+$
    LeadsExportCreateRequest:
      type: object
      properties:
        start_date:
          description: 'Export leads collected on and after start date (UTC). Format:
            YYYY-MM-DD'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
          example: '2020-12-20'
        end_date:
          description: 'Export leads collected on and before end date (UTC). Format:
            YYYY-MM-DD'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
          example: '2020-12-20'
        ad_id:
          description: ID for the ad collecting leads
          type: string
          pattern: ^\d+$
          example: '687201361754'
      required:
      - start_date
      - end_date
      - ad_id
    LeadsExportCreateResponse:
      type: object
      properties:
        leads_export_id:
          example: '123456789012'
          description: ID for the leads export job
          type: string
          pattern: ^\d+$
    LeadsExportStatus:
      type: string
      description: Status of a leads export job
      example: IN_PROGRESS
      enum:
      - IN_PROGRESS
      - FINISHED
      - FAILED
    LeadsExportResponseData:
      type: object
      properties:
        export_status:
          $ref: '#/components/schemas/LeadsExportStatus'
        download_url:
          type: string
          nullable: true
    LinkedBusiness:
      title: LinkedBusiness
      type: object
      properties:
        username:
          title: username
          type: string
          description: Username
          example: username
        image_small_url:
          title: image_small_url
          type: string
          description: image_small_url
          example: https://www.example.com/dj23454f53dfk2324.jpg
        image_medium_url:
          title: image_medium_url
          type: string
          description: image_medium_url
          example: https://www.example.com/dj23454f53dfk2324.jpg
        image_large_url:
          title: image_large_url
          type: string
          description: image_large_url
          example: https://www.example.com/dj23454f53dfk2324.jpg
        image_xlarge_url:
          title: image_xlarge_url
          type: string
          description: image_xlarge_url
          example: https://www.example.com/dj23454f53dfk2324.jpg
    MemberBusinessRole:
      type: string
      description: |-
        The access level a member/partner has to the business. Values are case-sensitive.
        <br> - EMPLOYEE: Can only view and access ad accounts you assign to them.
        They cannot see details about other employees, external partners or other ad accounts.
        <br> - BIZ_ADMIN: Have full control of roles and can add employees, external partners as well as grant ad account access.
      example: BIZ_ADMIN
      enum:
      - EMPLOYEE
      - BIZ_ADMIN
    MatchType:
      type: string
      description: Keyword match type
      example: BROAD
      enum:
      - BROAD
      - PHRASE
      - EXACT
      - EXACT_NEGATIVE
      - PHRASE_NEGATIVE
    MatchTypeResponse:
      type: string
      description: Keyword match type
      nullable: true
      example: BROAD
      enum:
      - BROAD
      - PHRASE
      - EXACT
      - EXACT_NEGATIVE
      - PHRASE_NEGATIVE
      - null
    MaxPriceFilter:
      type: object
      title: MAX_PRICE
      additionalProperties: false
      properties:
        MAX_PRICE:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupPricingCriteria'
      required:
      - MAX_PRICE
    MediaUpload:
      type: object
      title: Media upload
      description: Media upload that has been registered but not uploaded/processed
        yet.
      allOf:
      - type: object
        readOnly: true
        properties:
          media_id:
            type: string
            description: Unique identifier for this media upload. Used to track status
              and for attaching during Pin creation.
          media_type:
            allOf:
            - $ref: '#/components/schemas/MediaUploadType'
            type: string
            example: video
          upload_url:
            type: string
            description: The URL where you will POST your media file.
            example: https://pinterest-media-upload.s3-accelerate.amazonaws.com/
          upload_parameters:
            type: object
            description: The list of parameter key/value pairs you will need to send
              with your POST request to upload your media file.
            properties:
              x-amz-date:
                type: string
              x-amz-signature:
                type: string
              x-amz-security-token:
                type: string
              x-amz-algorithm:
                type: string
              key:
                type: string
              policy:
                type: string
              x-amz-credential:
                type: string
              Content-Type:
                type: string
                example: multipart/form-data
      example:
        media_id: '12345'
        media_type: video
        upload_url: https://pinterest-media-upload.s3-accelerate.amazonaws.com/
        upload_parameters:
          x-amz-data: 20220127T185143Z
          x-amz-signature: fcd6309a6aaee213348666a72abed8b44552a43acb6b340e8e1b288d21a5fe92
          key: uploads/11/aa/22/3:video:203014033110991560:5212123920968240771
          policy: eyJleHBpcmF0aW9uIjoiMj..==
          x-amz-credential: ASIA6QZJ64OPIKV7FRVX/20220127/us-east-1/s3/aws4_request
          x-amz-security-token: IQoJb3JpZ2luX2VjEJr...==
          x-amz-algorithm: AWS4-HMAC-SHA256
          Content-Type: multipart/form-data
    MediaUploadDetails:
      title: Media upload details
      description: Media upload details
      type: object
      properties:
        media_id:
          type: string
          pattern: ^\d+$
          readOnly: true
        media_type:
          allOf:
          - $ref: '#/components/schemas/MediaUploadType'
          type: string
          readOnly: true
        status:
          allOf:
          - $ref: '#/components/schemas/MediaUploadStatus'
          type: string
          readOnly: true
      example:
        media_id: '12345'
        media_type: video
        status: succeeded
    MediaUploadRequest:
      title: Media upload request
      description: Media upload request
      type: object
      properties:
        media_type:
          allOf:
          - $ref: '#/components/schemas/MediaUploadType'
          type: string
          writeOnly: true
      required:
      - media_type
      example:
        media_type: video
    MediaUploadStatus:
      description: Media upload status
      type: string
      enum:
      - registered
      - processing
      - succeeded
      - failed
    MediaUploadType:
      type: string
      enum:
      - video
    MembersToDeleteBody:
      required:
      - members
      properties:
        members:
          items:
            required:
            - member_id
            - business_role
            properties:
              member_id:
                type: string
                description: Unique identifier of the member
                maxLength: 25
                example: '140943737684417'
                pattern: ^\d+$
              business_role:
                $ref: '#/components/schemas/BusinessRoleForMembers'
            type: object
          type: array
          minItems: 1
          maxItems: 50
      type: object
    Metrics:
      description: The metric name and daily value for each requested metric
      type: object
      additionalProperties:
        type: number
      example:
        CLOSEUP: 1
        CLOSEUP_RATE: 0
        ENGAGEMENT: 1
        ENGAGEMENT_RATE: 0
        IMPRESSION: 240
        OUTBOUND_CLICK: 20
        OUTBOUND_CLICK_RATE: 0.08
        PIN_CLICK: 37
        PIN_CLICK_RATE: 0.15
        QUARTILE_95_PERCENT_VIEW: 8
        SAVE: 20
        SAVE_RATE: 0.18
        VIDEO_10S_VIEW: 2
        VIDEO_AVG_WATCH_TIME: 2507.75
        VIDEO_MRC_VIEW: 20
        VIDEO_START: 29
        VIDEO_V50_WATCH_TIME: 10031
    MetricsReportingLevel:
      type: string
      description: Level of the reporting request
      example: CAMPAIGN
      enum:
      - ADVERTISER
      - ADVERTISER_TARGETING
      - CAMPAIGN
      - CAMPAIGN_TARGETING
      - AD_GROUP
      - AD_GROUP_TARGETING
      - PIN_PROMOTION
      - PIN_PROMOTION_TARGETING
      - KEYWORD
      - PRODUCT_GROUP
      - PRODUCT_GROUP_TARGETING
      - PRODUCT_ITEM
      - PRODUCT_ITEM_TARGETING
    MetricsResponse:
      properties:
        data:
          items:
            type: object
          type: array
          example:
          - targeting_type: KEYWORD
            targeting_value: christmas decor ideas
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: APPTYPE
            targeting_value: iphone
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: APPTYPE
            targeting_value: ipad
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: APPTYPE
            targeting_value: web
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: APPTYPE
            targeting_value: web_mobile
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: APPTYPE
            targeting_value: android_mobile
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: APPTYPE
            targeting_value: android_tablet
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: GENDER
            targeting_value: female
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: LOCATION
            targeting_value: 500
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: PLACEMENT
            targeting_value: SEARCH
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: COUNTRY
            targeting_value: US
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: TARGETED_INTEREST
            targeting_value: Food and Drinks
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: PINNER_INTEREST
            targeting_value: Chocolate Cookies
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: AUDIENCE_INCLUDE
            targeting_value: 254261234567
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: GEO
            targeting_value: US:94102
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: AGE_BUCKET
            targeting_value: 45-49
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
          - targeting_type: REGION
            targeting_value: US-CA
            metrics:
              AD_GROUP_ID: 2680067996745
              DATE: '2022-04-26'
              SPEND_IN_DOLLAR: 240
      type: object
    PriceFilter:
      type: object
      title: PRICE
      additionalProperties: false
      properties:
        PRICE:
          type: object
          additionalProperties: false
          title: catalogs_product_group_pricing_currency_criteria
          properties:
            operator:
              type: string
              enum:
              - GREATER_THAN
              - GREATER_THAN_OR_EQUALS
              - LESS_THAN
              - LESS_THAN_OR_EQUALS
            value:
              type: number
              minimum: 0
            currency:
              $ref: '#/components/schemas/NonNullableCatalogsCurrency'
            negated:
              type: boolean
              default: false
          required:
          - value
          - operator
          - currency
      required:
      - PRICE
    MinPriceFilter:
      type: object
      title: MIN_PRICE
      additionalProperties: false
      properties:
        MIN_PRICE:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupPricingCriteria'
      required:
      - MIN_PRICE
    MMMReportingColumn:
      type: string
      description: Marketing Mix Modeling (MMM) Reporting Columns
      example: SPEND_IN_DOLLAR
      enum:
      - SPEND_IN_DOLLAR
      - SPEND_IN_MICRO_DOLLAR
      - ECPC_IN_DOLLAR
      - ECTR
      - CAMPAIGN_NAME
      - TOTAL_ENGAGEMENT
      - EENGAGEMENT_RATE
      - ECPM_IN_DOLLAR
      - CAMPAIGN_ID
      - ADVERTISER_ID
      - AD_GROUP_ID
      - AD_GROUP_NAME
      - CLICKTHROUGH_1
      - IMPRESSION_1
      - CLICKTHROUGH_2
      - IMPRESSION_2
      - TOTAL_CLICKTHROUGH
      - TOTAL_IMPRESSION
      - ADVERTISER_NAME
      - SPEND_ORDER_LINE_PAID_TYPE
    MMMReportingTargetingType:
      type: string
      description: Ad targeting types for MMM report
      example: APPTYPE
      enum:
      - APPTYPE
      - COUNTRY
      - CREATIVE_TYPE
      - GENDER
      - LOCATION
    NonNullableCatalogsCurrency:
      type: string
      description: Currency Codes from ISO 4217.
      nullable: false
      example: USD
      enum:
      - AED
      - AFN
      - ALL
      - AMD
      - ANG
      - AOA
      - ARS
      - AUD
      - AWG
      - AZN
      - BAM
      - BBD
      - BDT
      - BGN
      - BHD
      - BIF
      - BMD
      - BND
      - BOB
      - BRL
      - BSD
      - BTN
      - BWP
      - BYN
      - BYR
      - BZD
      - CAD
      - CDF
      - CHF
      - CLP
      - CNY
      - COP
      - CRC
      - CUC
      - CUP
      - CVE
      - CZK
      - DJF
      - DKK
      - DOP
      - DZD
      - EGP
      - ERN
      - ETB
      - EUR
      - FJD
      - FKP
      - GBP
      - GEL
      - GGP
      - GHS
      - GIP
      - GMD
      - GNF
      - GTQ
      - GYD
      - HKD
      - HNL
      - HRK
      - HTG
      - HUF
      - IDR
      - ILS
      - IMP
      - INR
      - IQD
      - IRR
      - ISK
      - JEP
      - JMD
      - JOD
      - JPY
      - KES
      - KGS
      - KHR
      - KMF
      - KPW
      - KRW
      - KWD
      - KYD
      - KZT
      - LAK
      - LBP
      - LKR
      - LRD
      - LSL
      - LYD
      - MAD
      - MDL
      - MGA
      - MKD
      - MMK
      - MNT
      - MOP
      - MRO
      - MUR
      - MVR
      - MWK
      - MXN
      - MYR
      - MZN
      - NAD
      - NGN
      - NIO
      - NOK
      - NPR
      - NZD
      - OMR
      - PAB
      - PEN
      - PGK
      - PHP
      - PKR
      - PLN
      - PYG
      - QAR
      - RON
      - RSD
      - RUB
      - RWF
      - SAR
      - SBD
      - SCR
      - SDG
      - SEK
      - SGD
      - SHP
      - SLL
      - SOS
      - SPL
      - SRD
      - STD
      - SVC
      - SYP
      - SZL
      - THB
      - TJS
      - TMT
      - TND
      - TOP
      - TRY
      - TTD
      - TVD
      - TWD
      - TZS
      - UAH
      - UGX
      - USD
      - UYU
      - UZS
      - VEF
      - VND
      - VUV
      - WST
      - XAF
      - XCD
      - XDR
      - XOF
      - XPF
      - YER
      - ZAR
      - ZMW
      - ZWD
    NonNullableProductAvailabilityType:
      description: Product availability.
      nullable: false
      type: string
      enum:
      - IN_STOCK
      - OUT_OF_STOCK
      - PREORDER
    Notification:
      type: object
      additionalProperties: true
      minProperties: 1
      maxProperties: 100
      description: Any valid JSON object with 1-100 properties
      example:
        id: notif-123
        type: custom_event
        data: null
        customField: value
    Notifications:
      type: array
      items:
        $ref: '#/components/schemas/Notification'
      minItems: 1
      maxItems: 100
      description: Array of 1-100 notification objects
      example:
      - event: user_created
        user_id: 123
      - type: order_update
        status: completed
    NullableCatalogsItemFieldType:
      description: Product item fields
      example: TITLE
      type: string
      nullable: true
      enum:
      - ITEM_ID
      - ITEM_GROUP_ID
      - TITLE
      - DESCRIPTION
      - ITEM_LINK
      - ORGANIC_LINK
      - IMAGE_LINK
      - ADWORDS_REDIRECT_LINK
      - AD_LINK
      - SIZE
      - GOOGLE_PRODUCT_CATEGORY
      - PRODUCT_CATEGORY
      - CONDITION
      - AVAILABILITY
      - GENDER
      - AGE_GROUP
      - SIZE_TYPE
      - SIZE_SYSTEM
      - ADULT
      - SHIPPING
      - SHIPPING_WEIGHT
      - TAX
      - MULTIPACK
      - ADDITIONAL_IMAGE_LINK
      - PRICE
      - SALE_PRICE
      - IS_BUNDLE
      - EXPIRATION_DATE
      - AVAILABILITY_DATE
      - WEIGHT_UNIT
      - PRODUCT_TYPE
      - CUSTOM_LABEL_0
      - CUSTOM_LABEL_1
      - CUSTOM_LABEL_2
      - CUSTOM_LABEL_3
      - CUSTOM_LABEL_4
      - MATERIAL
      - PATTERN
      - COLOR
      - BRAND
      - GTIN
      - MPN
      - IOS_DEEP_LINK
      - ANDROID_DEEP_LINK
      - FREE_SHIPPING_LABEL
      - FREE_SHIPPING_LIMIT
      - AVG_REVIEW_RATING
      - NUM_RATINGS
      - NUM_REVIEWS
      - ALT_TEXT
      - VARIANT_NAMES
      - VARIANT_VALUES
      - MIN_AD_PRICE
      - SHIPPING_WIDTH
      - SHIPPING_HEIGHT
      - AD_IMAGE_0_LINK
      - AD_IMAGE_1_LINK
      - AD_IMAGE_2_LINK
      - AD_IMAGE_3_LINK
      - AD_IMAGE_4_LINK
      - AD_IMAGE_5_LINK
      - AD_IMAGE_6_LINK
      - AD_IMAGE_7_LINK
      - AD_IMAGE_8_LINK
      - AD_IMAGE_9_LINK
      - AD_IMAGE_10_LINK
      - AD_IMAGE_11_LINK
      - AD_IMAGE_12_LINK
      - AD_IMAGE_13_LINK
      - AD_IMAGE_14_LINK
      - AD_IMAGE_15_LINK
      - AD_IMAGE_16_LINK
      - AD_IMAGE_17_LINK
      - AD_IMAGE_18_LINK
      - AD_IMAGE_19_LINK
      - AD_IMAGE_0_TAG
      - AD_IMAGE_1_TAG
      - AD_IMAGE_2_TAG
      - AD_IMAGE_3_TAG
      - AD_IMAGE_4_TAG
      - AD_IMAGE_5_TAG
      - AD_IMAGE_6_TAG
      - AD_IMAGE_7_TAG
      - AD_IMAGE_8_TAG
      - AD_IMAGE_9_TAG
      - AD_IMAGE_10_TAG
      - AD_IMAGE_11_TAG
      - AD_IMAGE_12_TAG
      - AD_IMAGE_13_TAG
      - AD_IMAGE_14_TAG
      - AD_IMAGE_15_TAG
      - AD_IMAGE_16_TAG
      - AD_IMAGE_17_TAG
      - AD_IMAGE_18_TAG
      - AD_IMAGE_19_TAG
      - AD_VIDEO_0_LINK
      - AD_VIDEO_1_LINK
      - AD_VIDEO_2_LINK
      - AD_VIDEO_0_TAG
      - AD_VIDEO_1_TAG
      - AD_VIDEO_2_TAG
      - INSTALLMENT_PRICE
      - UNIT_PRICE_TOTAL_MEASURE
      - UNIT_PRICE_BASE_MEASURE
      - SALE_PRICE_EFFECTIVE_DATE
      - null
    NullableCurrency:
      type: string
      description: Currency Codes from ISO 4217.
      example: USD
      nullable: true
      enum:
      - AED
      - AFN
      - ALL
      - AMD
      - ANG
      - AOA
      - ARS
      - AUD
      - AWG
      - AZN
      - BAM
      - BBD
      - BDT
      - BGN
      - BHD
      - BIF
      - BMD
      - BND
      - BOB
      - BRL
      - BSD
      - BTN
      - BWP
      - BYN
      - BYR
      - BZD
      - CAD
      - CDF
      - CHF
      - CLP
      - CNY
      - COP
      - CRC
      - CUC
      - CUP
      - CVE
      - CZK
      - DJF
      - DKK
      - DOP
      - DZD
      - EGP
      - ERN
      - ETB
      - EUR
      - FJD
      - FKP
      - GBP
      - GEL
      - GGP
      - GHS
      - GIP
      - GMD
      - GNF
      - GTQ
      - GYD
      - HKD
      - HNL
      - HRK
      - HTG
      - HUF
      - IDR
      - ILS
      - IMP
      - INR
      - IQD
      - IRR
      - ISK
      - JEP
      - JMD
      - JOD
      - JPY
      - KES
      - KGS
      - KHR
      - KMF
      - KPW
      - KRW
      - KWD
      - KYD
      - KZT
      - LAK
      - LBP
      - LKR
      - LRD
      - LSL
      - LYD
      - MAD
      - MDL
      - MGA
      - MKD
      - MMK
      - MNT
      - MOP
      - MRO
      - MUR
      - MVR
      - MWK
      - MXN
      - MYR
      - MZN
      - NAD
      - NGN
      - NIO
      - NOK
      - NPR
      - NZD
      - OMR
      - PAB
      - PEN
      - PGK
      - PHP
      - PKR
      - PLN
      - PYG
      - QAR
      - RON
      - RSD
      - RUB
      - RWF
      - SAR
      - SBD
      - SCR
      - SDG
      - SEK
      - SGD
      - SHP
      - SLL
      - SOS
      - SPL
      - SRD
      - STD
      - SVC
      - SYP
      - SZL
      - THB
      - TJS
      - TMT
      - TND
      - TOP
      - TRY
      - TTD
      - TVD
      - TWD
      - TZS
      - UAH
      - UGX
      - USD
      - UYU
      - UZS
      - VEF
      - VND
      - VUV
      - WST
      - XAF
      - XCD
      - XDR
      - XOF
      - XPF
      - YER
      - ZAR
      - ZMW
      - ZWD
      - null
    OauthAccessTokenRequest:
      title: OAuth access token request
      description: Describes the valid schema for possible OAuth access token requests.
      type: object
      discriminator:
        propertyName: grant_type
        mapping:
          authorization_code: '#/components/schemas/OauthAccessTokenRequestCode'
          refresh_token: '#/components/schemas/OauthAccessTokenRequestRefresh'
          client_credentials: '#/components/schemas/OauthAccessTokenRequestClientCredentials'
      properties:
        grant_type:
          type: string
          enum:
          - authorization_code
          - refresh_token
          - client_credentials
      required:
      - grant_type
    OauthAccessTokenRequestCode:
      type: object
      title: authorization_code
      description: A request to exchange an authorization code for an access token.
      allOf:
      - type: object
        properties:
          code:
            type: string
          redirect_uri:
            type: string
          continuous_refresh:
            description: Setting this value to true will have a <a href="/docs/getting-started/set-up-authentication-and-authorization/#exchange-the-default-refresh-token-for-a-continuous-refresh-token">continuous
              refresh token</a> be returned from this endpoint rather than the current
              legacy, 1-year expiry, refresh token.
            type: boolean
        required:
        - code
        - redirect_uri
      properties:
        grant_type:
          type: string
          enum:
          - authorization_code
          - refresh_token
          - client_credentials
      required:
      - grant_type
    OauthAccessTokenRequestRefresh:
      title: refresh_token
      description: A request to exchange a refresh token for a new access token.
      type: object
      allOf:
      - type: object
        properties:
          refresh_token:
            type: string
          scope:
            type: string
        required:
        - refresh_token
      properties:
        grant_type:
          type: string
          enum:
          - authorization_code
          - refresh_token
          - client_credentials
      required:
      - grant_type
    OauthAccessTokenRequestClientCredentials:
      title: client_credentials
      description: A request to receive a client token.
      type: object
      allOf:
      - type: object
        properties:
          scope:
            type: string
        required:
        - scope
      properties:
        grant_type:
          type: string
          enum:
          - authorization_code
          - refresh_token
          - client_credentials
      required:
      - grant_type
    OauthAccessTokenResponse:
      title: OAuth access token response
      description: A successful OAuth access token response.
      type: object
      discriminator:
        propertyName: response_type
        mapping:
          authorization_code: '#/components/schemas/OauthAccessTokenResponseCode'
          refresh_token: '#/components/schemas/OauthAccessTokenResponseRefresh'
          client_credentials: '#/components/schemas/OauthAccessTokenResponseClientCredentials'
          integration_refresh: '#/components/schemas/OauthAccessTokenResponseIntegrationRefresh'
      properties:
        response_type:
          type: string
          enum:
          - authorization_code
          - refresh_token
          - client_credentials
        access_token:
          type: string
        token_type:
          type: string
          default: bearer
        expires_in:
          type: integer
        scope:
          type: string
      required:
      - access_token
      - token_type
      - expires_in
      - scope
    OauthAccessTokenResponseCode:
      title: OAuth access token response
      description: A successful OAuth access token response for the authorization
        code flow.
      type: object
      allOf:
      - type: object
        properties:
          refresh_token:
            type: string
          refresh_token_expires_in:
            type: integer
          refresh_token_expires_at:
            type: integer
      properties:
        response_type:
          type: string
          enum:
          - authorization_code
          - refresh_token
          - client_credentials
        access_token:
          type: string
        token_type:
          type: string
          default: bearer
        expires_in:
          type: integer
        scope:
          type: string
      required:
      - access_token
      - token_type
      - expires_in
      - scope
    OauthAccessTokenResponseIntegrationRefresh:
      title: OAuth access token response
      description: A successful OAuth access token response for the refresh token
        flow, with an added refresh token.
      type: object
      allOf:
      - type: object
        properties:
          refresh_token:
            type: string
          refresh_token_expires_in:
            type: integer
        required:
        - refresh_token
        - refresh_token_expires_in
      properties:
        response_type:
          type: string
          enum:
          - authorization_code
          - refresh_token
          - client_credentials
        access_token:
          type: string
        token_type:
          type: string
          default: bearer
        expires_in:
          type: integer
        scope:
          type: string
      required:
      - access_token
      - token_type
      - expires_in
      - scope
    TokenRevocationRequest:
      description: Describes the valid schema for token revocation requests.
      type: object
      properties:
        token:
          description: The token to revoke.
          type: string
          example: pinr.eyJhbGciOiJS...
        token_type_hint:
          description: The type of the token to revoke. Please refer to [our developer
            guide for more information](https://developers.pinterest.com/docs/getting-started/set-up-authentication-and-authorization/)
            for more information.
          type: string
          enum:
          - access_token
          - refresh_token
      required:
      - token
    OauthAccessTokenResponseRefresh:
      title: OAuth access token response
      description: A successful OAuth access token response for the refresh token
        flow.
      type: object
      allOf:
      - type: object
        properties:
          response_type:
            type: string
            enum:
            - authorization_code
            - refresh_token
            - client_credentials
          access_token:
            type: string
          token_type:
            type: string
            default: bearer
          expires_in:
            type: integer
          scope:
            type: string
        required:
        - access_token
        - token_type
        - expires_in
        - scope
      - type: object
        properties:
          refresh_token:
            type: string
          refresh_token_expires_in:
            type: integer
          refresh_token_expires_at:
            type: integer
        required:
        - refresh_token
        - refresh_token_expires_in
        - refresh_token_expires_at
      required:
      - refresh_token
      - refresh_token_expires_in
      - refresh_token_expires_at
    OauthAccessTokenResponseClientCredentials:
      title: OAuth client token response
      description: A successful OAuth client token response for the client token flow.
      type: object
      properties:
        response_type:
          type: string
          enum:
          - authorization_code
          - refresh_token
          - client_credentials
        access_token:
          type: string
        token_type:
          type: string
          default: bearer
        expires_in:
          type: integer
        scope:
          type: string
      required:
      - access_token
      - token_type
      - expires_in
      - scope
    ObjectiveType:
      type: string
      description: "Intended result of the campaign. \nYou can only update objectives\
        \ for draft campaigns.\n`WEB_SESSIONS` and `VIDEO_VIEW` objectives are deprecated.\
        \ We recommend using `VIDEO_COMPLETION` as an alternative for the latter. "
      enum:
      - AWARENESS
      - CONSIDERATION
      - WEB_CONVERSION
      - CATALOG_SALES
      - VIDEO_COMPLETION
    OptimizationGoalMetadata:
      type: object
      properties:
        conversion_tag_v3_goal_metadata:
          properties:
            attribution_windows:
              properties:
                click_window_days:
                  type: integer
                engagement_window_days:
                  type: integer
                view_window_days:
                  type: integer
              type: object
            conversion_event:
              type: string
              enum:
              - PAGE_VISIT
              - SIGNUP
              - CHECKOUT
              - CUSTOM
              - VIEW_CATEGORY
              - SEARCH
              - ADD_TO_CART
              - WATCH_VIDEO
              - LEAD
              - APP_INSTALL
            conversion_tag_id:
              type: string
              pattern: ^[0-9]+$
            cpa_goal_value_in_micro_currency:
              type: string
              pattern: ^[0-9]+$
            is_roas_optimized:
              description: Pinterest Performance+ ROAS bidding. When enabled, Pinterest
                will optimize for conversion value instead of conversion volume. Only
                supported when `conversion_event` is set to `"CHECKOUT"` and `bid_strategy_type`
                is set to `"AUTOMATIC_BID"`. <br>This parameter is not enabled for
                all advertisers. <a href="https://developers.pinterest.com/docs/getting-started/using-beta-and-restricted-features/">Learn
                more</a>.
              nullable: true
              title: is_roas_optimized
              type: boolean
            learning_mode_type:
              description: Conversion learning model type
              enum:
              - NOT_ACTIVE
              - ACTIVE
              - null
              example: ACTIVE
              nullable: true
              title: ConversionLearningModeType
              type: string
            reporting_event:
              description: Event name for custom or standard events mapped to an oCPM
                model
              example: INITIATE_CHECKOUT
              type: string
          type: object
        frequency_goal_metadata:
          properties:
            frequency:
              type: integer
              description: Frequency target can only be between 2 and 20
              minimum: 2
              maximum: 20
            timerange:
              type: string
              description: User entity counts time range
              example: DAY
              enum:
              - THIRTY_DAY
              - DAY
              - SEVEN_DAY
              - TWENTY_MINUTE
              - TEN_MINUTE
              - TWENTY_FOUR_HOUR
          type: object
        scrollup_goal_metadata:
          properties:
            scrollup_goal_value_in_micro_currency:
              pattern: ^[0-9]+$
              type: string
              nullable: true
          type: object
    OrderLine:
      type: object
      allOf:
      - $ref: '#/components/schemas/OrderLines'
      - type: object
        properties:
          campaign_ids:
            description: Associated List of campaign IDs.
            example:
            - '626735565838'
            items:
              type: string
            title: campaign_ids
            type: array
        required:
        - campaign_ids
      title: OrderLine
    OrderLineError:
      properties:
        data:
          $ref: '#/components/schemas/OrderLine'
          type: object
        error_messages:
          items:
            type: string
          title: error_messages
          type: array
      title: OrderLineError
      type: object
    OrderLinePaidType:
      description: Order Line Paid Type
      enum:
      - PAID
      - BONUS
      - MAKE_GOOD
      - TEST
      - null
      example: PAID
      title: OrderLinePaidType
      type: string
      nullable: true
    OrderLineResponse:
      properties:
        errors:
          description: Error list if update(s) fail.
          items:
            $ref: '#/components/schemas/OrderLineError'
            type: object
          title: errors
          type: array
        order_line:
          description: Order Line object array.
          items:
            $ref: '#/components/schemas/OrderLine'
            type: object
          title: order_line
          type: array
      title: OrderLineResponse
      type: object
    OrderLineSingleResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/OrderLineResponse'
          type: object
      title: OrderLineSingleResponse
    OrderLineStatus:
      description: Order Line Status
      enum:
      - ACTIVE
      - PAUSED
      - DELETED
      example: ACTIVE
      title: OrderLineStatus
      type: string
    OrderLines:
      type: object
      title: OrderLines
      description: Order Line
      properties:
        id:
          description: Order line ID.
          example: '2680059592705'
          pattern: ^\d+$
          title: id
          type: string
        type:
          description: Always "orderline".
          example: orderline
          title: type
          type: string
        ad_account_id:
          description: Ad account ID.
          example: '549755885175'
          title: ad_account_id
          type: string
        purchase_order_id:
          description: Purchase order ID.
          example: PO12345
          title: purchase_order_id
          type: string
          nullable: true
        start_time:
          description: Start time. Unix timestamp.
          example: 1452208622
          title: start_time
          type: number
        end_time:
          description: End time. Unix timestamp.
          example: 1461269616
          title: end_time
          type: number
          nullable: true
        budget:
          description: Order line budget in micro currency.
          example: 5000000
          title: budget
          type: number
          nullable: true
        paid_budget:
          description: Order line paid budget in micro currency.
          example: 5000000
          title: paid_budget
          type: number
          nullable: true
        status:
          allOf:
          - $ref: '#/components/schemas/OrderLineStatus'
          description: Order line status.
          example: ACTIVE
          type: string
          title: status
        name:
          description: Order line name.
          example: Order Line Name 1
          title: name
          type: string
          nullable: true
        paid_type:
          allOf:
          - $ref: '#/components/schemas/OrderLinePaidType'
          type: string
          description: Order line paid type.
          example: PAID
          title: paid_type
          nullable: true
    OrderLinesArrayResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/OrderLines'
      title: OrderLinesArrayResponse
    PacingDeliveryType:
      type: string
      description: Ad group pacing delivery type. With ACCELERATED, an ad group budget
        is spent as fast as possible. With STANDARD, an ad group budget is spent smoothly
        over a day. When using CBO, only the STANDARD pacing delivery type is allowed.
      example: STANDARD
      enum:
      - STANDARD
      - ACCELERATED
    Paginated:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
        bookmark:
          type: string
          nullable: true
      required:
      - items
    Permissions:
      type: string
      enum:
      - ADMIN
      - ANALYST
      - FINANCE_MANAGER
      - FINANCE_EDIT
      - FINANCE_VIEW
      - AUDIENCE_MANAGER
      - CAMPAIGN_MANAGER
      - CATALOGS_MANAGER
      - CATALOGS_VIEWER
      - PROFILE_PUBLISHER
      - CONSUMER_USER
    PermissionsResponse:
      type: array
      description: Permission levels member or partner has on an asset.
      example:
      - FINANCE_MANAGER
      - CATALOGS_MANAGER
      - AUDIENCE_MANAGER
      items:
        type: string
    PermissionsWithOwner:
      type: string
      enum:
      - ADMIN
      - ANALYST
      - FINANCE_MANAGER
      - FINANCE_EDIT
      - FINANCE_VIEW
      - AUDIENCE_MANAGER
      - CAMPAIGN_MANAGER
      - CATALOGS_MANAGER
      - CATALOGS_VIEWER
      - PROFILE_PUBLISHER
      - OWNER
    Pin:
      type: object
      required:
      - id
      properties:
        alt_text:
          type: string
          nullable: true
          maxLength: 500
        board_id:
          type: string
          pattern: ^\d+$
          description: The board to which this Pin belongs.
        board_owner:
          allOf:
          - type: object
            properties:
              username:
                type: string
                readOnly: true
            title: Board owner containing the username.
          readOnly: true
        board_section_id:
          type: string
          nullable: true
          pattern: ^\d+$
          description: The board section to which this Pin belongs.
        created_at:
          type: string
          format: date-time
          readOnly: true
        creative_type:
          allOf:
          - $ref: '#/components/schemas/CreativeType'
          nullable: true
          readOnly: true
        description:
          type: string
          nullable: true
          maxLength: 800
        dominant_color:
          type: string
          nullable: true
          description: Dominant pin color. Hex number, e.g. `#6E7874`.
        has_been_promoted:
          type: boolean
          description: Whether the Pin has been promoted or not.
          readOnly: true
        id:
          type: string
          pattern: ^\d+$
        is_owner:
          type: boolean
          description: Whether the "operation user_account" is the Pin owner.
          readOnly: true
        is_standard:
          type: boolean
          description: Whether the Pin is standard or not. See documentation on [Changes
            to Pin creation](/docs/api-features/content-overview/) for more information.
          readOnly: true
        link:
          type: string
          nullable: true
          maxLength: 2048
        media:
          allOf:
          - $ref: '#/components/schemas/PinMedia'
          readOnly: true
        note:
          type: string
          nullable: true
          description: Private note for this Pin. [Learn more](https://help.pinterest.com/en/article/add-notes-to-your-pins).
        parent_pin_id:
          type: string
          nullable: true
          pattern: ^\d+$
          description: The source pin id if this pin was saved from another pin. [Learn
            more](https://help.pinterest.com/article/save-pins-on-pinterest).
        pin_metrics:
          type: object
          nullable: true
          description: Pin metrics with associated time intervals if any.
          example:
            90d:
              pin_click: 7
              impression: 2
              clickthrough: 3
            lifetime_metrics:
              pin_click: 7
              impression: 2
              clickthrough: 3
              reaction: 10
              comment: 2
          readOnly: true
        title:
          type: string
          nullable: true
          maxLength: 100
      description: Pin model containing properties related to a Pinterest Pin.
    PinAnalyticsMetricsResponse:
      type: object
      properties:
        lifetime_metrics:
          description: The lifetime metric name and value.
          type: object
          additionalProperties:
            type: integer
          example:
            TOTAL_COMMENTS: 10
            TOTAL_REACTIONS: 12
        daily_metrics:
          description: Array with the requested daily metric records
          items:
            type: object
            properties:
              data_status:
                $ref: '#/components/schemas/DataStatus'
              date:
                description: 'Metrics date (UTC): YYYY-MM-DD.'
                example: '2019-12-01'
                type: string
              metrics:
                description: The metric name and daily value for each requested metric
                type: object
                additionalProperties:
                  type: number
                example:
                  IMPRESSION: 240
                  OUTBOUND_CLICK: 20
                  PIN_CLICK: 37
                  QUARTILE_95_PERCENT_VIEW: 8
                  SAVE: 20
                  SAVE_RATE: 0.18
                  VIDEO_10S_VIEW: 2
                  VIDEO_AVG_WATCH_TIME: 2507.75
                  VIDEO_MRC_VIEW: 20
                  VIDEO_START: 29
                  VIDEO_V50_WATCH_TIME: 10031
          type: array
        summary_metrics:
          description: The metric name and value over the requested period for each
            requested metric
          type: object
          additionalProperties:
            type: number
          example:
            IMPRESSION: 240
            OUTBOUND_CLICK: 20
            PIN_CLICK: 37
            QUARTILE_95_PERCENT_VIEW: 8
            SAVE: 20
            SAVE_RATE: 0.18
            VIDEO_10S_VIEW: 2
            VIDEO_AVG_WATCH_TIME: 2507.75
            VIDEO_MRC_VIEW: 20
            VIDEO_START: 29
            VIDEO_V50_WATCH_TIME: 10031
    PinAnalyticsResponse:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/PinAnalyticsMetricsResponse'
    BulkPinAnalyticsResponse:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/PinAnalyticsResponse'
    PinCreate:
      type: object
      properties:
        alt_text:
          type: string
          nullable: true
          maxLength: 500
        board_id:
          type: string
          pattern: ^\d+$
          description: The board to which this Pin belongs.
        board_section_id:
          type: string
          nullable: true
          pattern: ^\d+$
          description: The board section to which this Pin belongs.
        description:
          type: string
          nullable: true
          maxLength: 800
        dominant_color:
          type: string
          nullable: true
          description: Dominant pin color. Hex number, e.g. `#6E7874`.
        link:
          type: string
          nullable: true
          maxLength: 2048
        media_source:
          $ref: '#/components/schemas/PinMediaSource'
        note:
          type: string
          nullable: true
          description: Private note for this Pin. [Learn more](https://help.pinterest.com/en/article/add-notes-to-your-pins).
        parent_pin_id:
          type: string
          nullable: true
          pattern: ^\d+$
          description: The source pin id if this pin was saved from another pin. [Learn
            more](https://help.pinterest.com/article/save-pins-on-pinterest).
        title:
          type: string
          nullable: true
          maxLength: 100
        sponsor_id:
          type: string
          nullable: true
          pattern: ^\d+$
          description: The sponsor account id to request paid partnership from.  Currently
            the field is only available to a list of users in a closed beta.
      description: Resource create operation model.
    PinMedia:
      type: object
      oneOf:
      - $ref: '#/components/schemas/PinMediaWithImage'
      - $ref: '#/components/schemas/PinMediaWithVideo'
      - $ref: '#/components/schemas/PinMediaWithImages'
      - $ref: '#/components/schemas/PinMediaWithVideos'
      - $ref: '#/components/schemas/PinMediaWithImageAndVideo'
      discriminator:
        propertyName: media_type
        mapping:
          image: '#/components/schemas/PinMediaWithImage'
          video: '#/components/schemas/PinMediaWithVideo'
          multiple_images: '#/components/schemas/PinMediaWithImages'
          multiple_videos: '#/components/schemas/PinMediaWithVideos'
          multiple_mixed: '#/components/schemas/PinMediaWithImageAndVideo'
      description: Pin media that can be an image, video, or a mix of both.
      title: Pin media response object.
    PinMediaMetadata:
      anyOf:
      - $ref: '#/components/schemas/ImageMetadata'
      - $ref: '#/components/schemas/VideoMetadataWithItemType'
    PinMediaSource:
      type: object
      oneOf:
      - $ref: '#/components/schemas/PinMediaSourceImageBase64'
      - $ref: '#/components/schemas/PinMediaSourceImageURL'
      - $ref: '#/components/schemas/PinMediaSourceVideoID'
      - $ref: '#/components/schemas/PinMediaSourceImagesBase64'
      - $ref: '#/components/schemas/PinMediaSourceImagesURL'
      - $ref: '#/components/schemas/PinMediaSourcePinURL'
      discriminator:
        propertyName: source_type
        mapping:
          image_base64: '#/components/schemas/PinMediaSourceImageBase64'
          image_url: '#/components/schemas/PinMediaSourceImageURL'
          video_id: '#/components/schemas/PinMediaSourceVideoID'
          multiple_image_base64: '#/components/schemas/PinMediaSourceImagesBase64'
          multiple_image_urls: '#/components/schemas/PinMediaSourceImagesURL'
          pin_url: '#/components/schemas/PinMediaSourcePinURL'
      description: Pin media source that can be an image, video, or a mix of both
        passed in as a request.
    PinMediaSourceImageBase64:
      type: object
      required:
      - source_type
      - content_type
      - data
      properties:
        source_type:
          type: string
          enum:
          - image_base64
          description: The source type of the media.
        is_standard:
          type: boolean
          description: Set the parameter to false to create the new simplified Pin
            instead of the standard pin. Currently the field is only available to
            a list of beta users.
          default: true
        content_type:
          $ref: '#/components/schemas/ContentType'
        data:
          type: string
          pattern: ^[a-zA-Z0-9+/=]+$
      description: Image Base64-based media source.
      title: Object containing Base64 format
    PinMediaSourceImageURL:
      type: object
      required:
      - source_type
      - url
      properties:
        source_type:
          type: string
          enum:
          - image_url
          description: The source type of the media.
        is_standard:
          type: boolean
          description: Set the parameter to false to create the new simplified Pin
            instead of the standard pin. Currently the field is only available to
            a list of beta users.
          default: true
        url:
          type: string
      description: Image URL-based media source.
      title: Object containing Image URL
    PinMediaSourceImagesBase64:
      type: object
      required:
      - source_type
      - items
      properties:
        source_type:
          type: string
          enum:
          - multiple_image_base64
          description: The source type of the media.
        items:
          type: array
          items:
            $ref: '#/components/schemas/PinMediaSourceImagesBase64Item'
          minItems: 2
          maxItems: 5
          description: Array with image objects.
        index:
          type: integer
          minimum: 0
      description: Multiple Base64-based images media source
      title: Object containing Base64 image definitions
    PinMediaSourceImagesBase64Item:
      type: object
      required:
      - content_type
      - data
      properties:
        content_type:
          $ref: '#/components/schemas/ContentType'
        data:
          type: string
          pattern: ^[a-zA-Z0-9+/=]+$
        description:
          type: string
        link:
          type: string
        title:
          type: string
    PinMediaSourceImagesURL:
      type: object
      required:
      - source_type
      - items
      properties:
        source_type:
          type: string
          enum:
          - multiple_image_urls
          description: The source type of the media.
        items:
          type: array
          items:
            $ref: '#/components/schemas/PinMediaSourceImagesURLItem'
          minItems: 2
          maxItems: 5
          description: Array with image objects.
        index:
          type: integer
          minimum: 0
      description: Multiple URL-based images media source
      title: Object containing images url definitions
    PinMediaSourceImagesURLItem:
      type: object
      required:
      - url
      properties:
        url:
          type: string
        description:
          type: string
        link:
          type: string
        title:
          type: string
    PinMediaSourcePinURL:
      type: object
      required:
      - source_type
      properties:
        is_affiliate_link:
          type: boolean
          description: This is an affiliate link or sponsored product. The FTC requires
            disclosure for paid partnerships and affiliate products.
          default: false
        source_type:
          type: string
          enum:
          - pin_url
      description: Pin URL-based media source for product pin creation. Currently
        the field is only available to a list of beta users.
      title: Media object containing URL type definition.
    PinMediaSourceVideoID:
      type: object
      required:
      - media_id
      - source_type
      properties:
        cover_image_content_type:
          allOf:
          - $ref: '#/components/schemas/ContentType'
          description: Content type for cover image Base64.
        cover_image_data:
          type: string
          description: Cover image Base64.
        cover_image_key_frame_time:
          type: integer
          minimum: 0
          description: Keyframe timestamp for cover image (seconds). If entered time
            exceeds video duration, the last frame is used.
        cover_image_url:
          type: string
          description: Cover image URL.
        is_standard:
          type: boolean
          description: Set the parameter to false to create the new simplified Pin
            instead of the standard pin. Currently the field is only available to
            a list of beta users.
          default: true
        media_id:
          type: string
          pattern: ^\d+$
        source_type:
          type: string
          enum:
          - video_id
      description: Video ID-based media source.
      title: Object containing Video ID definitions.
    PinMediaWithImage:
      type: object
      required:
      - media_type
      properties:
        media_type:
          type: string
          enum:
          - image
        images:
          $ref: '#/components/schemas/ImageSize'
      description: Pin with image.
      title: Object containing image definitions.
    PinMediaWithImageAndVideo:
      type: object
      required:
      - media_type
      properties:
        media_type:
          type: string
          enum:
          - multiple_mixed
        items:
          type: array
          items:
            $ref: '#/components/schemas/PinMediaMetadata'
      description: Pin with a mix of images and videos.
      title: Object containing video and image definitions.
    PinMediaWithImages:
      type: object
      required:
      - media_type
      properties:
        media_type:
          type: string
          enum:
          - multiple_images
        items:
          type: array
          items:
            $ref: '#/components/schemas/ImageMetadata'
      description: Pin with multiple images.
      title: Object containing images definitions.
    PinMediaWithVideo:
      type: object
      required:
      - media_type
      properties:
        media_type:
          type: string
          enum:
          - video
        cover_image_url:
          type: string
        duration:
          type: number
          nullable: true
          description: Duration (in miliseconds). Field maybe null after creation
            due to video processing time.
        height:
          type: integer
          nullable: true
          description: Height (in pixels). Field maybe null after creation due to
            video processing time.
        video_url:
          type: string
          nullable: true
          description: |-
            Video url (720p).

            **Note:** This field is limited and not available to all apps.
        width:
          type: integer
          nullable: true
          description: Width (in pixels). Field maybe null after creation due to video
            processing time.
        images:
          $ref: '#/components/schemas/ImageSize'
      description: Pin with video.
      title: Object containing video definitions.
    PinMediaWithVideos:
      type: object
      required:
      - media_type
      properties:
        media_type:
          type: string
          enum:
          - multiple_videos
        items:
          type: array
          items:
            $ref: '#/components/schemas/VideoMetadataWithItemType'
      description: Pin with multiple videos.
      title: Object containing videos definitions.
    PinPromotionSummaryStatus:
      type: string
      description: Summary status for pin promotions
      example: APPROVED
      enum:
      - APPROVED
      - PAUSED
      - PENDING
      - REJECTED
      - ADVERTISER_DISABLED
      - ARCHIVED
      - DRAFT
      - DELETED_DRAFT
    PinUpdate:
      type: object
      properties:
        alt_text:
          type: string
          nullable: true
          maxLength: 500
        board_id:
          type: string
          pattern: ^\d+$
          description: The board to which this Pin belongs.
        board_section_id:
          type: string
          nullable: true
          pattern: ^\d+$
          description: The board section to which this Pin belongs.
        description:
          type: string
          nullable: true
          maxLength: 800
        link:
          type: string
          nullable: true
          maxLength: 2048
        note:
          type: string
          nullable: true
          description: Private note for this Pin. [Learn more](https://help.pinterest.com/en/article/add-notes-to-your-pins).
        title:
          type: string
          nullable: true
          maxLength: 100
        carousel_slots:
          type: array
          items:
            $ref: '#/components/schemas/CarouselSlot'
          description: Carousel Pin slots data.
      description: Resource create or update operation model.
    PlacementGroupType:
      type: string
      description: Campaign placement group type
      example: ALL
      default: ALL
      enum:
      - ALL
      - SEARCH
      - BROWSE
      - OTHER
    ProductAvailabilityType:
      nullable: true
      description: Default availability for products in a feed.
      type: string
      enum:
      - IN_STOCK
      - OUT_OF_STOCK
      - PREORDER
      - null
    ProductGroupAnalyticsResponse:
      type: array
      items:
        type: object
        properties:
          PRODUCT_GROUP_ID:
            description: The ID of the product group that this metrics belongs to.
            type: string
            pattern: ^\d+$
          DATE:
            description: Current metrics date. Only returned when granularity is a
              time-based value (`DAY`, `HOUR`, `WEEK`, `MONTH`)
            type: string
            format: date
        required:
        - PRODUCT_GROUP_ID
        additionalProperties: true
        example:
          DATE: '2021-04-01'
          PRODUCT_GROUP_ID: '74629351736530'
          SPEND_IN_DOLLAR: 30
          TOTAL_CLICKTHROUGH: 216
    ProductGroupPromotion:
      properties:
        id:
          description: ID of the product group promotion.
          example: '2680059592705'
          title: id
          type: string
          pattern: ^\d+$
        ad_group_id:
          description: ID of the ad group the product group belongs to.
          example: '2680059592705'
          pattern: ^(AG)?\d+$
          title: ad_group_id
          type: string
        bid_in_micro_currency:
          description: The bid in micro currency.
          example: 14000000
          title: bid_in_micro_currency
          type: integer
          nullable: true
        included:
          description: True if the group is BIDDABLE, false if it should be EXCLUDED
            from serving ads.
          example: true
          nullable: true
          title: included
          type: boolean
        definition:
          description: The full product group definition path
          example: '*/product_type_0=''kitchen''/product_type_1=''beverage appliances'''
          nullable: true
          title: definition
          type: string
        relative_definition:
          description: The definition of the product group, relative to its parent
            - an attribute name/value pair
          example: product_type_1='beverage appliances'
          nullable: true
          title: relative_definition
          type: string
        parent_id:
          description: The parent Product Group ID of this Product Group
          example: '1231234'
          nullable: true
          title: parent_id
          type: string
          pattern: ^\d+$
        slideshow_collections_title:
          description: Slideshow Collections Title
          example: slideshow title
          nullable: true
          title: slideshow_collections_title
          type: string
        slideshow_collections_description:
          description: Slideshow Collections Description
          example: slideshow description
          nullable: true
          title: slideshow_collections_description
          type: string
        is_mdl:
          description: If set to true products promoted in this product group will
            use the Mobile Deep Link specified in your catalog
          example: true
          nullable: true
          title: is_mdl
          type: boolean
        status:
          $ref: '#/components/schemas/EntityStatus'
        tracking_url:
          description: Tracking template for proudct group promotions. 4000 limit
          example: https://www.pinterest.com
          nullable: true
          title: tracking_url
          type: string
        catalog_product_group_id:
          description: ID of the catalogs product group that this product group promotion
            references
          example: '1231235'
          title: catalog_product_group_id
          type: string
          pattern: ^\d+$
          nullable: true
        catalog_product_group_name:
          description: Catalogs product group name
          example: catalogProductGroupName
          title: product_group_promotion_name
          type: string
          nullable: true
        creative_type:
          $ref: '#/components/schemas/CreativeType'
        collections_hero_pin_id:
          description: Hero Pin ID if this PG is promoted as a Collection
          example: '123123'
          nullable: true
          title: collections_hero_pin_id
          type: string
          pattern: ^\d+$
        collections_hero_destination_url:
          description: Collections Hero Destination Url
          example: http://www.pinterest.com
          nullable: true
          title: collections_hero_destination_url
          type: string
        grid_click_type:
          $ref: '#/components/schemas/GridClickType'
        is_generate_background:
          type: boolean
          description: Enable generate backgrounds for the product group, default
            value is FALSE. When enabled, Pinterest will use generative AI to apply
            backgrounds for your product images that help drive user inspiration and
            engagement.
          example: true
          nullable: true
        customizable_cta_type:
          type: string
          description: Select a call to action (CTA) to display below your ad. CTA
            options for catalog sales campaigns are SHOP_NOW, BOOK_NOW, ON_SALE, GET_DEAL
          example: SHOP_NOW
          nullable: true
          enum:
          - SHOP_NOW
          - BOOK_NOW
          - ON_SALE
          - GET_DEAL
          - null
        collections_header_type:
          type: string
          nullable: true
          description: Collections ad header type
          example: SHOP_THIS_COLLECTION
          enum:
          - SHOP_THIS_COLLECTION
          - EXPLORE_THIS_COLLECTION
          - NO_HEADER
          - ON_SALE
          - GET_DEAL
          - null
        selected_image_tag:
          type: string
          description: The ad image tag selected for the product group promotion.
          example: holiday_sale
          nullable: true
        preferred_media_type:
          type: string
          nullable: true
          description: Select whether to promote the image or video pin by default
            for items in the promoted product group. If selecting IMAGE, image will
            be promoted for all ads in the product group, and when selecting VIDEO,
            video will be promoted when present, otherwise fall back to image. This
            is applicable for standard shopping ads only.
          example: VIDEO
          enum:
          - VIDEO
          - IMAGE
          - null
        selected_video_tag:
          type: string
          description: The ad video tag selected for the product group promotion.
          example: holiday_sale
          nullable: true
      type: object
      title: ProductGroupPromotion
    ProductGroupPromotionCreateRequest:
      example:
        product_group_promotion:
        - slideshow_collections_description: Description
          creative_type: REGULAR
          collections_hero_pin_id: '123123'
          catalog_product_group_name: catalogProductGroupName
          collections_hero_destination_url: http://www.pinterest.com
          tracking_url: https://www.pinterest.com
          slideshow_collections_title: Title
          is_mdl: true
          status: ACTIVE
        - slideshow_collections_description: Description
          creative_type: REGULAR
          collections_hero_pin_id: '123123'
          catalog_product_group_name: catalogProductGroupName
          collections_hero_destination_url: http://www.pinterest.com
          tracking_url: https://www.pinterest.com
          slideshow_collections_title: Title
          is_mdl: true
          status: ACTIVE
        ad_group_id: '2680059592705'
      properties:
        ad_group_id:
          description: ID of the Ad Group the Product Group Promotion belongs to.
          example: '2680059592705'
          pattern: ^(AG)?\d+$
          title: ad_group_id
          type: string
        product_group_promotion:
          items:
            $ref: '#/components/schemas/ProductGroupPromotion'
          title: product_group_promotion
          type: array
      required:
      - ad_group_id
      - product_group_promotion
      title: ProductGroupPromotionCreateRequest
      type: object
    ProductGroupPromotionResponse:
      type: object
      title: ProductGroupPromotionResponse
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ProductGroupPromotionResponseItem'
    ProductGroupPromotionResponseItem:
      type: object
      title: ProductGroupPromotionResponseItem
      properties:
        data:
          $ref: '#/components/schemas/ProductGroupPromotion'
        exceptions:
          nullable: true
          items:
            nullable: true
            $ref: '#/components/schemas/Exception'
    ProductGroupPromotionUpdateRequest:
      example:
        product_group_promotion:
        - catalog_product_group_id: '1234123'
          slideshow_collections_description: Description
          creative_type: REGULAR
          collections_hero_pin_id: '123123'
          catalog_product_group_name: ProductGroupName
          collections_hero_destination_url: http://www.pinterest.com
          tracking_url: https://www.pinterest.com
          slideshow_collections_title: Title
          status: ACTIVE
          id: '2680059592705'
        - catalog_product_group_id: '1231231'
          slideshow_collections_description: Other description
          creative_type: REGULAR
          collections_hero_pin_id: '123124'
          catalog_product_group_name: ProductGroupName
          collections_hero_destination_url: http://www.pinterest.com
          tracking_url: https://www.pinterest.com
          slideshow_collections_title: Title
          status: ACTIVE
          id: '2680059592706'
        ad_group_id: '26823439592705'
      properties:
        ad_group_id:
          description: ID of the ad group the product group belongs to.
          example: '2680059592705'
          pattern: ^(AG)?\d+$
          title: ad_group_id
          type: string
        product_group_promotion:
          items:
            $ref: '#/components/schemas/ProductGroupPromotion'
          title: product_group_promotion
          type: array
      required:
      - ad_group_id
      - product_group_promotion
      title: ProductGroupPromotionUpdateRequest
      type: object
    ProductGroupSummaryStatus:
      type: string
      description: Summary status for product group
      example: RUNNING
      enum:
      - RUNNING
      - PAUSED
      - EXCLUDED
      - ARCHIVED
    ProductType0Filter:
      type: object
      title: PRODUCT_TYPE_0
      additionalProperties: false
      properties:
        PRODUCT_TYPE_0:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - PRODUCT_TYPE_0
    ProductType1Filter:
      type: object
      title: PRODUCT_TYPE_1
      additionalProperties: false
      properties:
        PRODUCT_TYPE_1:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - PRODUCT_TYPE_1
    ProductType2Filter:
      type: object
      title: PRODUCT_TYPE_2
      additionalProperties: false
      properties:
        PRODUCT_TYPE_2:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - PRODUCT_TYPE_2
    ProductType3Filter:
      type: object
      title: PRODUCT_TYPE_3
      additionalProperties: false
      properties:
        PRODUCT_TYPE_3:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - PRODUCT_TYPE_3
    ProductType4Filter:
      type: object
      title: PRODUCT_TYPE_4
      additionalProperties: false
      properties:
        PRODUCT_TYPE_4:
          type: object
          $ref: '#/components/schemas/CatalogsProductGroupMultipleStringListCriteria'
      required:
      - PRODUCT_TYPE_4
    PromotionArrayElement:
      title: PromotionArrayElement
      type: object
      properties:
        data:
          $ref: '#/components/schemas/PromotionResponse'
        exception:
          $ref: '#/components/schemas/Exception'
    PromotionCommon:
      title: Promotion
      type: object
      properties:
        external_id:
          description: Platform-specific ID for this promotion. Will be null for promotions
            first created within Pinterest.
          example: abc
          type: string
          maxLength: 64
        promotion_custom_id:
          description: An optional field for user defined promotion ID for this promotion.
            Will copy from Pinterest system generated ID if user did not provide one.
          example: freeshipping_2025
          type: string
          maxLength: 50
        platform_type:
          description: The source integration platform used when creating the promotion.
            Currently supported values are 'DEFAULT' and 'SHOPIFY'.
          example: DEFAULT
          type: string
        promotion_title:
          description: Internal name for the promotion.
          example: Black Friday 10% off
          type: string
        promotion_code:
          description: Code that can be used to redeem a promotion.
          example: blackfriday10
          type: string
        start_time:
          description: Promotion start time. Unix timestamp in seconds. Independent
            of campaign start time.
          example: 1677003860
          type: integer
        end_time:
          description: Promotion end time. Unix timestamp in seconds. Independent
            of campaign end time.
          example: 1678003860
          type: integer
        promotion_type:
          $ref: '#/components/schemas/PromotionType'
        template_values:
          description: List of values to be inserted in the promotion type-specific
            template.
          type: array
          minItems: 0
          maxItems: 2
          items:
            $ref: '#/components/schemas/PromotionTemplateValue'
        discount_status:
          type: string
          description: Discount status based on the current time and start and end
            time of discount
          example: ACTIVE
          enum:
          - OTHER
          - ACTIVE
          - PAUSED
          - SCHEDULED
          - EXPIRED
    PromotionCreateRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/PromotionCommon'
      - type: object
        title: PromotionCreateRequest
        required:
        - promotion_title
        - promotion_type
    PromotionResponse:
      title: PromotionResponse
      type: object
      allOf:
      - $ref: '#/components/schemas/PromotionCommon'
      - type: object
        properties:
          id:
            description: Promotion ID
            type: string
            pattern: ^\d+$
            example: '7834020347906'
          ad_account_id:
            description: The Ad Account ID that this promotion belongs to.
            example: '549755885175'
            type: string
            pattern: ^\d+$
          status:
            $ref: '#/components/schemas/EntityStatus'
    PromotionTemplateValue:
      title: Promotion template value
      type: object
      properties:
        amount:
          description: Numeric value.
          example: 100
          type: number
        percent:
          description: Percent value.
          example: 10
          type: number
        currency_code:
          $ref: '#/components/schemas/Currency'
        custom_text:
          description: Custom text.
          example: My promotion
          type: string
    PromotionType:
      type: string
      description: Determines the displayed promotion text along with what parameters
        (if any) are needed to complete the template. This list is not finalized,
        and will be updated as new types are supported.
      example: VARIABLE
      enum:
      - VARIABLE
      - SITEWIDE
      - CHECKOUT
      - SAVE_X_ON_Y
      - BUY_X_GET_Y
      - SPEND_X_SAVE_Y
      - FREE_SHIPPING
      - FREE_SHIPPING_MINIMUM
      - FREE_SHIPPING_WITH_DISCOUNT
      - SITEWIDE_IN_STORES
      - EXTRA_PERCENT_OFF
      - GIFT_WITH_PURCHASE
      - GIFT_WITH_PURCHASE_MINIMUM
      - FIXED
      - PERCENT_OFF_CLEARANCE
      - X_OFF_Y
      - GIFT_WITH_FIRST_PURCHASE
      - BUY_X_GET_ONE_FREE
      - CASH_BACK
      - POINTS_ON_ALL_PURCHASES
      - BONUS
      - POINTS_WITH_PURCHASE
      - CUSTOM
    PromotionUpdateRequest:
      title: PromotionUpdateRequest
      type: object
      allOf:
      - $ref: '#/components/schemas/PromotionCommon'
      - type: object
        properties:
          id:
            description: Promotion ID
            type: string
            pattern: ^\d+$
            example: '7834020347906'
          status:
            $ref: '#/components/schemas/EntityStatus'
        required:
        - id
    PromotionsResponse:
      title: PromotionsResponse
      type: object
      properties:
        promotions:
          type: array
          items:
            $ref: '#/components/schemas/PromotionArrayElement'
    QuizPinData:
      description: This field includes all quiz data including questions, options,
        and results.
      example:
        questions:
        - question_id: 1
          question_text: Where do you thrive?
          options:
          - text: Hangout vibes
          - text: Time to party!
          - text: Keeping it lowkey
        - question_id: 2
          question_text: Where would you nap?
          options:
          - text: Hammock in the mountains
          - text: Beach towel in the sand
          - text: Tent under the stars
        - question_id: 2
          question_text: Who are you taking?
          options:
          - text: "No one\u2014solo trip!"
          - text: My best friend
          - text: The family
        results:
        - organicPinId: '1234'
          android_deep_link: https://www.pinterest.com/
          iOS_deep_link: https://www.pinterest.com/
          destination_url: https://www.pinterest.com/
          result_id: 1
        - organicPinId: '1234'
          android_deep_link: https://www.pinterest.com/
          iOS_deep_link: https://www.pinterest.com/
          destination_url: https://www.pinterest.com/
          result_id: 2
        - organicPinId: '1234'
          android_deep_link: https://www.pinterest.com/
          iOS_deep_link: https://www.pinterest.com/
          destination_url: https://www.pinterest.com/
          result_id: 3
      type: object
      nullable: true
      properties:
        questions:
          type: array
          items:
            $ref: '#/components/schemas/QuizPinQuestion'
        results:
          type: array
          items:
            $ref: '#/components/schemas/QuizPinResult'
        tie_breaker_type:
          type: string
          description: Quiz ad tie breaker type, default is RANDOM
          enum:
          - RANDOM
          - CUSTOM
        tie_breaker_custom_result:
          $ref: '#/components/schemas/QuizPinResult'
    QuizPinOption:
      description: ' This field contains multiple options to a quiz question.'
      example:
        id: 1
        text: Where do you thrive?
      type: object
      nullable: true
      properties:
        id:
          type: number
        text:
          type: string
    QuizPinQuestion:
      description: A specific quiz inquiry.
      example:
        question_id: 1
        question_text: Where do you thrive?
        options:
        - text: Hangout vibes
        - text: Time to party!
        - text: Keeping it lowkey
      type: object
      nullable: true
      properties:
        question_id:
          type: number
        question_text:
          type: string
        options:
          type: array
          items:
            $ref: '#/components/schemas/QuizPinOption'
    QuizPinResult:
      description: "The result, and link out, based on the user\u2019s choice."
      example:
        organic_pin_id: pinId
        android_deep_link: https://www.pinterest.com/
        ios_deep_link: https://www.pinterest.com/
        destination_url: https://www.pinterest.com/
      type: object
      nullable: true
      properties:
        organic_pin_id:
          type: string
        android_deep_link:
          type: string
        ios_deep_link:
          type: string
        destination_url:
          type: string
        result_id:
          type: number
    RelatedTerms:
      type: object
      properties:
        id:
          description: First input term. For example, if you pass "?terms=clothes,workout",
            then id will be "clothes"
          type: string
          example: clothes
        related_term_count:
          description: Total number of related terms returned
          type: integer
          example: 2
        related_terms_list:
          description: The id of the advertiser.
          type: array
          items:
            type: object
            properties:
              term:
                type: string
                example: clothes
              related_terms:
                type: array
                items:
                  type: string
                example:
                - shoes
                - cute clothes
    ReportingColumnAsync:
      type: string
      description: Reporting columns
      example: SPEND_IN_MICRO_DOLLAR
      enum:
      - SPEND_IN_MICRO_DOLLAR
      - ADS_CREDIT_SPEND_IN_MICRO_DOLLAR
      - ADS_CREDIT_SPEND_IN_DOLLAR
      - PAID_IMPRESSION
      - SPEND_IN_DOLLAR
      - CPC_IN_MICRO_DOLLAR
      - ECPC_IN_MICRO_DOLLAR
      - ECPC_IN_DOLLAR
      - CTR
      - ECTR
      - OUTBOUND_CTR
      - OUTBOUND_CTR_1
      - COST_PER_OUTBOUND_CLICK
      - CAMPAIGN_NAME
      - CAMPAIGN_STATUS
      - CAMPAIGN_BRAND_LABEL
      - PIN_PROMOTION_STATUS
      - AD_STATUS
      - PIN_ID
      - TOTAL_ENGAGEMENT
      - ENGAGEMENT_1
      - ENGAGEMENT_2
      - ECPE_IN_DOLLAR
      - ENGAGEMENT_RATE
      - EENGAGEMENT_RATE
      - ECPM_IN_MICRO_DOLLAR
      - REPIN_RATE
      - CTR_2
      - CAMPAIGN_ID
      - ADVERTISER_ID
      - AD_ACCOUNT_ID
      - PIN_PROMOTION_ID
      - AD_ID
      - AD_GROUP_ID
      - CAMPAIGN_ENTITY_STATUS
      - CAMPAIGN_MANAGED_STATUS
      - CAMPAIGN_OBJECTIVE_TYPE
      - CPM_IN_MICRO_DOLLAR
      - CPM_IN_DOLLAR
      - AD_GROUP_NAME
      - AD_GROUP_STATUS
      - AD_GROUP_BUDGET_TYPE
      - AD_GROUP_BUDGET_IN_LOCAL_CURRENCY
      - AD_GROUP_ENTITY_STATUS
      - AD_GROUP_BID_MULTIPLIER
      - PRODUCT_GROUP_ID
      - PRODUCT_GROUP_STATUS
      - PROMO_ID
      - PROMO_NAME
      - PRODUCT_ITEM_NAME
      - PRODUCT_ITEM_IMAGE_URL
      - PRODUCT_ITEM_PRICE
      - PRODUCT_ITEM_PRODUCT_URL
      - PRODUCT_ITEM_PIN_URL
      - PRODUCT_ITEM_BRAND
      - PRODUCT_ITEM_DESCRIPTION
      - PRODUCT_ITEM_SALE_PRICE
      - PRODUCT_ITEM_PRODUCT_TYPE
      - PRODUCT_ITEM_PRODUCT_CATEGORY
      - ORDER_LINE_ID
      - ORDER_LINE_NAME
      - CLICKTHROUGH_1
      - REPIN_1
      - IMPRESSION_1
      - IMPRESSION_1_GROSS
      - CLICKTHROUGH_1_GROSS
      - OUTBOUND_CLICK_1
      - CLICKTHROUGH_2
      - REPIN_2
      - IMPRESSION_2
      - OUTBOUND_CLICK_2
      - TOTAL_CLICKTHROUGH
      - TOTAL_IMPRESSION
      - TOTAL_IMPRESSION_USER
      - TOTAL_IMPRESSION_FREQUENCY
      - COST_PER_OUTBOUND_CLICK_IN_DOLLAR
      - COST_PER_OUTBOUND_CLICK_IN_DOLLAR_1
      - TOTAL_ENGAGEMENT_PAGE_VISIT
      - TOTAL_ENGAGEMENT_SIGNUP
      - TOTAL_ENGAGEMENT_CHECKOUT
      - TOTAL_ENGAGEMENT_CUSTOM
      - TOTAL_ENGAGEMENT_ADD_TO_CART
      - TOTAL_ENGAGEMENT_LEAD
      - TOTAL_ENGAGEMENT_SEARCH
      - TOTAL_ENGAGEMENT_WATCH_VIDEO
      - TOTAL_ENGAGEMENT_VIEW_CATEGORY
      - TOTAL_ENGAGEMENT_APP_INSTALL
      - TOTAL_ENGAGEMENT_UNKNOWN
      - TOTAL_CLICK_PAGE_VISIT
      - TOTAL_CLICK_SIGNUP
      - TOTAL_CLICK_CHECKOUT
      - TOTAL_CLICK_CUSTOM
      - TOTAL_CLICK_ADD_TO_CART
      - TOTAL_CLICK_LEAD
      - TOTAL_CLICK_SEARCH
      - TOTAL_CLICK_WATCH_VIDEO
      - TOTAL_CLICK_VIEW_CATEGORY
      - TOTAL_CLICK_APP_INSTALL
      - TOTAL_CLICK_UNKNOWN
      - TOTAL_VIEW_PAGE_VISIT
      - TOTAL_VIEW_SIGNUP
      - TOTAL_VIEW_CHECKOUT
      - TOTAL_VIEW_CUSTOM
      - TOTAL_VIEW_ADD_TO_CART
      - TOTAL_VIEW_LEAD
      - TOTAL_VIEW_SEARCH
      - TOTAL_VIEW_WATCH_VIDEO
      - TOTAL_VIEW_VIEW_CATEGORY
      - TOTAL_VIEW_APP_INSTALL
      - TOTAL_VIEW_UNKNOWN
      - TOTAL_CONVERSIONS
      - TOTAL_ENGAGEMENT_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CONVERSIONS_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ENGAGEMENT_PAGE_VISIT_QUANTITY
      - TOTAL_ENGAGEMENT_SIGNUP_QUANTITY
      - TOTAL_ENGAGEMENT_CHECKOUT_QUANTITY
      - TOTAL_ENGAGEMENT_CUSTOM_QUANTITY
      - TOTAL_ENGAGEMENT_ADD_TO_CART_QUANTITY
      - TOTAL_ENGAGEMENT_LEAD_QUANTITY
      - TOTAL_ENGAGEMENT_SEARCH_QUANTITY
      - TOTAL_ENGAGEMENT_WATCH_VIDEO_QUANTITY
      - TOTAL_ENGAGEMENT_VIEW_CATEGORY_QUANTITY
      - TOTAL_ENGAGEMENT_UNKNOWN_QUANTITY
      - TOTAL_CLICK_PAGE_VISIT_QUANTITY
      - TOTAL_CLICK_SIGNUP_QUANTITY
      - TOTAL_CLICK_CHECKOUT_QUANTITY
      - TOTAL_CLICK_CUSTOM_QUANTITY
      - TOTAL_CLICK_ADD_TO_CART_QUANTITY
      - TOTAL_CLICK_LEAD_QUANTITY
      - TOTAL_CLICK_SEARCH_QUANTITY
      - TOTAL_CLICK_WATCH_VIDEO_QUANTITY
      - TOTAL_CLICK_VIEW_CATEGORY_QUANTITY
      - TOTAL_CLICK_UNKNOWN_QUANTITY
      - TOTAL_VIEW_PAGE_VISIT_QUANTITY
      - TOTAL_VIEW_SIGNUP_QUANTITY
      - TOTAL_VIEW_CHECKOUT_QUANTITY
      - TOTAL_VIEW_CUSTOM_QUANTITY
      - TOTAL_VIEW_ADD_TO_CART_QUANTITY
      - TOTAL_VIEW_LEAD_QUANTITY
      - TOTAL_VIEW_SEARCH_QUANTITY
      - TOTAL_VIEW_WATCH_VIDEO_QUANTITY
      - TOTAL_VIEW_VIEW_CATEGORY_QUANTITY
      - TOTAL_VIEW_UNKNOWN_QUANTITY
      - TOTAL_CONVERSIONS_QUANTITY
      - TOTAL_WEB_SESSIONS
      - WEB_SESSIONS_1
      - WEB_SESSIONS_2
      - ONSITE_CHECKOUTS_1
      - PIN_PROMOTION_NAME
      - AD_NAME
      - CAMPAIGN_LIFETIME_SPEND_CAP
      - AD_GROUP_OPTIMIZATION
      - CAMPAIGN_DAILY_SPEND_CAP
      - CAMPAIGN_BUDGET_OPTIMIZATION
      - IS_PREMIERE_CAMPAIGN
      - TOTAL_PAGE_VISIT_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_PAGE_VISIT_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_PAGE_VISIT_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_PAGE_VISIT_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_PAGE_VISIT_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_PAGE_VISIT_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_PAGE_VISIT_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_PAGE_VISIT_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_PAGE_VISIT_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_SIGNUP_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_SIGNUP_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_SIGNUP_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_SIGNUP_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_SIGNUP_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_SIGNUP_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_SIGNUP_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_SIGNUP_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_SIGNUP_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_CHECKOUT_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_CHECKOUT_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_CHECKOUT_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_CHECKOUT_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_CHECKOUT_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_CHECKOUT_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_CHECKOUT_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_CHECKOUT_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_CHECKOUT_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_CUSTOM_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_CUSTOM_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_CUSTOM_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_CUSTOM_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_CUSTOM_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_CUSTOM_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_CUSTOM_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_CUSTOM_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_CUSTOM_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_ADD_TO_CART_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_ADD_TO_CART_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_ADD_TO_CART_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_ADD_TO_CART_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_ADD_TO_CART_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_ADD_TO_CART_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_ADD_TO_CART_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_ADD_TO_CART_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_ADD_TO_CART_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_LEAD_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_LEAD_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_LEAD_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_LEAD_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_LEAD_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_LEAD_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_LEAD_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_LEAD_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_LEAD_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_SEARCH_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_SEARCH_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_SEARCH_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_SEARCH_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_SEARCH_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_SEARCH_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_SEARCH_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_SEARCH_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_SEARCH_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_WATCH_VIDEO_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_WATCH_VIDEO_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_WATCH_VIDEO_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_WATCH_VIDEO_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_WATCH_VIDEO_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_WATCH_VIDEO_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_WATCH_VIDEO_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_WATCH_VIDEO_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_WATCH_VIDEO_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_VIEW_CATEGORY_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_VIEW_CATEGORY_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_VIEW_CATEGORY_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_VIEW_CATEGORY_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_VIEW_CATEGORY_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_VIEW_CATEGORY_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_VIEW_CATEGORY_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_VIEW_CATEGORY_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_VIEW_CATEGORY_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_APP_INSTALL_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_APP_INSTALL_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_APP_INSTALL_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_APP_INSTALL_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_APP_INSTALL_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_APP_INSTALL_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_APP_INSTALL_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_APP_INSTALL_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_APP_INSTALL_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_UNKNOWN_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_UNKNOWN_DESKTOP_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_UNKNOWN_DESKTOP_ACTION_TO_TABLET_CONVERSION
      - TOTAL_UNKNOWN_MOBILE_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_UNKNOWN_MOBILE_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_UNKNOWN_MOBILE_ACTION_TO_TABLET_CONVERSION
      - TOTAL_UNKNOWN_TABLET_ACTION_TO_DESKTOP_CONVERSION
      - TOTAL_UNKNOWN_TABLET_ACTION_TO_MOBILE_CONVERSION
      - TOTAL_UNKNOWN_TABLET_ACTION_TO_TABLET_CONVERSION
      - TOTAL_PAGE_VISIT
      - TOTAL_SIGNUP
      - TOTAL_CHECKOUT
      - TOTAL_CUSTOM
      - TOTAL_ADD_TO_CART
      - TOTAL_LEAD
      - TOTAL_SEARCH
      - TOTAL_WATCH_VIDEO
      - TOTAL_VIEW_CATEGORY
      - TOTAL_APP_INSTALL
      - TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
      - TOTAL_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
      - TOTAL_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
      - TOTAL_CHECKOUT_QUANTITY
      - PAGE_VISIT_COST_PER_ACTION
      - APP_INSTALL_COST_PER_ACTION
      - PAGE_VISIT_ROAS
      - CHECKOUT_ROAS
      - CUSTOM_ROAS
      - PRODUCT_GROUP_AD_IMAGE_TAG
      - PRODUCT_GROUP_AD_VIDEO_TAG
      - VIDEO_3SEC_VIEWS_1
      - VIDEO_P100_COMPLETE_1
      - VIDEO_P0_COMBINED_1
      - VIDEO_P25_COMBINED_1
      - VIDEO_P50_COMBINED_1
      - VIDEO_P75_COMBINED_1
      - VIDEO_P95_COMBINED_1
      - VIDEO_MRC_VIEWS_1
      - VIDEO_3SEC_VIEWS_2
      - VIDEO_P100_COMPLETE_2
      - VIDEO_P0_COMBINED_2
      - VIDEO_P25_COMBINED_2
      - VIDEO_P50_COMBINED_2
      - VIDEO_P75_COMBINED_2
      - VIDEO_P95_COMBINED_2
      - VIDEO_MRC_VIEWS_2
      - PAID_VIDEO_VIEWABLE_RATE
      - VIDEO_LENGTH
      - VIDEO_SPEND_IN_DOLLAR
      - CPV_IN_MICRO_DOLLAR
      - ECPV_IN_DOLLAR
      - CPCV_IN_MICRO_DOLLAR
      - ECPCV_IN_DOLLAR
      - CPCV_P95_IN_MICRO_DOLLAR
      - ECPCV_P95_IN_DOLLAR
      - TOTAL_VIDEO_3SEC_VIEWS
      - TOTAL_VIDEO_P100_COMPLETE
      - TOTAL_VIDEO_P0_COMBINED
      - TOTAL_VIDEO_P25_COMBINED
      - TOTAL_VIDEO_P50_COMBINED
      - TOTAL_VIDEO_P75_COMBINED
      - TOTAL_VIDEO_P95_COMBINED
      - TOTAL_VIDEO_MRC_VIEWS
      - VIDEO_AVG_WATCHTIME_IN_SECOND_1
      - VIDEO_AVG_WATCHTIME_IN_SECOND_2
      - TOTAL_VIDEO_AVG_WATCHTIME_IN_SECOND
      - TOTAL_DESTINATION_VIEWS
      - TOTAL_REPIN_RATE
      - WEB_CHECKOUT_COST_PER_ACTION
      - WEB_CHECKOUT_ROAS
      - TOTAL_WEB_CHECKOUT
      - TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_CHECKOUT
      - TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_CHECKOUT
      - TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_CHECKOUT
      - TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - INAPP_CHECKOUT_COST_PER_ACTION
      - INAPP_CHECKOUT_ROAS
      - TOTAL_INAPP_CHECKOUT
      - TOTAL_INAPP_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_CLICK_CHECKOUT
      - TOTAL_INAPP_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_ENGAGEMENT_CHECKOUT
      - TOTAL_INAPP_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_VIEW_CHECKOUT
      - TOTAL_INAPP_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - OFFLINE_CHECKOUT_COST_PER_ACTION
      - OFFLINE_CHECKOUT_ROAS
      - TOTAL_OFFLINE_CHECKOUT
      - TOTAL_OFFLINE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_CLICK_CHECKOUT
      - TOTAL_OFFLINE_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_ENGAGEMENT_CHECKOUT
      - TOTAL_OFFLINE_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_VIEW_CHECKOUT
      - TOTAL_OFFLINE_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - PINTEREST_CHECKOUT_COST_PER_ACTION
      - PINTEREST_CHECKOUT_ROAS
      - TOTAL_PINTEREST_CHECKOUT
      - TOTAL_PINTEREST_CHECKOUT_VALUE_IN_MICRO_DOLLAR
      - WEB_ADD_TO_CART_COST_PER_ACTION
      - WEB_ADD_TO_CART_ROAS
      - TOTAL_WEB_ADD_TO_CART
      - TOTAL_WEB_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_ADD_TO_CART
      - TOTAL_WEB_CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_ADD_TO_CART
      - TOTAL_WEB_ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_ADD_TO_CART
      - TOTAL_WEB_VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - INAPP_ADD_TO_CART_COST_PER_ACTION
      - INAPP_ADD_TO_CART_ROAS
      - TOTAL_INAPP_ADD_TO_CART
      - TOTAL_INAPP_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_CLICK_ADD_TO_CART
      - TOTAL_INAPP_CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_ENGAGEMENT_ADD_TO_CART
      - TOTAL_INAPP_ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_VIEW_ADD_TO_CART
      - TOTAL_INAPP_VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
      - WEB_PAGE_VISIT_COST_PER_ACTION
      - WEB_PAGE_VISIT_ROAS
      - TOTAL_WEB_PAGE_VISIT
      - TOTAL_WEB_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_PAGE_VISIT
      - TOTAL_WEB_CLICK_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_PAGE_VISIT
      - TOTAL_WEB_ENGAGEMENT_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_PAGE_VISIT
      - TOTAL_WEB_VIEW_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
      - WEB_SIGNUP_COST_PER_ACTION
      - WEB_SIGNUP_ROAS
      - TOTAL_WEB_SIGNUP
      - TOTAL_WEB_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_SIGNUP
      - TOTAL_WEB_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_SIGNUP
      - TOTAL_WEB_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_SIGNUP
      - TOTAL_WEB_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - INAPP_SIGNUP_COST_PER_ACTION
      - INAPP_SIGNUP_ROAS
      - TOTAL_INAPP_SIGNUP
      - TOTAL_INAPP_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_CLICK_SIGNUP
      - TOTAL_INAPP_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_ENGAGEMENT_SIGNUP
      - TOTAL_INAPP_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_VIEW_SIGNUP
      - TOTAL_INAPP_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - OFFLINE_SIGNUP_COST_PER_ACTION
      - OFFLINE_SIGNUP_ROAS
      - TOTAL_OFFLINE_SIGNUP
      - TOTAL_OFFLINE_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_CLICK_SIGNUP
      - TOTAL_OFFLINE_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_ENGAGEMENT_SIGNUP
      - TOTAL_OFFLINE_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_VIEW_SIGNUP
      - TOTAL_OFFLINE_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR
      - WEB_WATCH_VIDEO_COST_PER_ACTION
      - WEB_WATCH_VIDEO_ROAS
      - TOTAL_WEB_WATCH_VIDEO
      - TOTAL_WEB_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_WATCH_VIDEO
      - TOTAL_WEB_CLICK_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_WATCH_VIDEO
      - TOTAL_WEB_ENGAGEMENT_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_WATCH_VIDEO
      - TOTAL_WEB_VIEW_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
      - WEB_LEAD_COST_PER_ACTION
      - WEB_LEAD_ROAS
      - TOTAL_WEB_LEAD
      - TOTAL_WEB_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_LEAD
      - TOTAL_WEB_CLICK_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_LEAD
      - TOTAL_WEB_ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_LEAD
      - TOTAL_WEB_VIEW_LEAD_VALUE_IN_MICRO_DOLLAR
      - OFFLINE_LEAD_COST_PER_ACTION
      - OFFLINE_LEAD_ROAS
      - TOTAL_OFFLINE_LEAD
      - TOTAL_OFFLINE_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_CLICK_LEAD
      - TOTAL_OFFLINE_CLICK_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_ENGAGEMENT_LEAD
      - TOTAL_OFFLINE_ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_VIEW_LEAD
      - TOTAL_OFFLINE_VIEW_LEAD_VALUE_IN_MICRO_DOLLAR
      - WEB_SEARCH_COST_PER_ACTION
      - WEB_SEARCH_ROAS
      - TOTAL_WEB_SEARCH
      - TOTAL_WEB_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_SEARCH
      - TOTAL_WEB_CLICK_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_SEARCH
      - TOTAL_WEB_ENGAGEMENT_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_SEARCH
      - TOTAL_WEB_VIEW_SEARCH_VALUE_IN_MICRO_DOLLAR
      - INAPP_SEARCH_COST_PER_ACTION
      - INAPP_SEARCH_ROAS
      - TOTAL_INAPP_SEARCH
      - TOTAL_INAPP_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_CLICK_SEARCH
      - TOTAL_INAPP_CLICK_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_ENGAGEMENT_SEARCH
      - TOTAL_INAPP_ENGAGEMENT_SEARCH_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_VIEW_SEARCH
      - TOTAL_INAPP_VIEW_SEARCH_VALUE_IN_MICRO_DOLLAR
      - WEB_VIEW_CATEGORY_COST_PER_ACTION
      - WEB_VIEW_CATEGORY_ROAS
      - TOTAL_WEB_VIEW_CATEGORY
      - TOTAL_WEB_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_VIEW_CATEGORY
      - TOTAL_WEB_CLICK_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_VIEW_CATEGORY
      - TOTAL_WEB_ENGAGEMENT_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_VIEW_CATEGORY
      - TOTAL_WEB_VIEW_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
      - WEB_CUSTOM_COST_PER_ACTION
      - WEB_CUSTOM_ROAS
      - TOTAL_WEB_CUSTOM
      - TOTAL_WEB_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_CUSTOM
      - TOTAL_WEB_CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_CUSTOM
      - TOTAL_WEB_ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_CUSTOM
      - TOTAL_WEB_VIEW_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - OFFLINE_CUSTOM_COST_PER_ACTION
      - OFFLINE_CUSTOM_ROAS
      - TOTAL_OFFLINE_CUSTOM
      - TOTAL_OFFLINE_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_CLICK_CUSTOM
      - TOTAL_OFFLINE_CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_ENGAGEMENT_CUSTOM
      - TOTAL_OFFLINE_ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_VIEW_CUSTOM
      - TOTAL_OFFLINE_VIEW_CUSTOM_VALUE_IN_MICRO_DOLLAR
      - WEB_UNKNOWN_COST_PER_ACTION
      - WEB_UNKNOWN_ROAS
      - TOTAL_WEB_UNKNOWN
      - TOTAL_WEB_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_CLICK_UNKNOWN
      - TOTAL_WEB_CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_ENGAGEMENT_UNKNOWN
      - TOTAL_WEB_ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_WEB_VIEW_UNKNOWN
      - TOTAL_WEB_VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - INAPP_UNKNOWN_COST_PER_ACTION
      - INAPP_UNKNOWN_ROAS
      - TOTAL_INAPP_UNKNOWN
      - TOTAL_INAPP_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_CLICK_UNKNOWN
      - TOTAL_INAPP_CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_ENGAGEMENT_UNKNOWN
      - TOTAL_INAPP_ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_VIEW_UNKNOWN
      - TOTAL_INAPP_VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - OFFLINE_UNKNOWN_COST_PER_ACTION
      - OFFLINE_UNKNOWN_ROAS
      - TOTAL_OFFLINE_UNKNOWN
      - TOTAL_OFFLINE_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_CLICK_UNKNOWN
      - TOTAL_OFFLINE_CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_ENGAGEMENT_UNKNOWN
      - TOTAL_OFFLINE_ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - TOTAL_OFFLINE_VIEW_UNKNOWN
      - TOTAL_OFFLINE_VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR
      - INAPP_APP_INSTALL_COST_PER_ACTION
      - INAPP_APP_INSTALL_ROAS
      - TOTAL_INAPP_APP_INSTALL
      - TOTAL_INAPP_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_CLICK_APP_INSTALL
      - TOTAL_INAPP_CLICK_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_ENGAGEMENT_APP_INSTALL
      - TOTAL_INAPP_ENGAGEMENT_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
      - TOTAL_INAPP_VIEW_APP_INSTALL
      - TOTAL_INAPP_VIEW_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
      - IDEA_PIN_PAGE_FORWARD_1
      - IDEA_PIN_PAGE_FORWARD_2
      - IDEA_PIN_PAGE_BACKWARD_1
      - IDEA_PIN_PAGE_BACKWARD_2
      - TOTAL_IDEA_PIN_PAGE_FORWARD
      - TOTAL_IDEA_PIN_PAGE_BACKWARD
      - IDEA_PIN_PRODUCT_TAG_VISIT_1
      - IDEA_PIN_PRODUCT_TAG_VISIT_2
      - TOTAL_IDEA_PIN_PRODUCT_TAG_VISIT
      - LEADS
      - COST_PER_LEAD
      - QUIZ_COMPLETED
      - QUIZ_COMPLETION_RATE
      - SHOWCASE_PIN_CLICKTHROUGH
      - SHOWCASE_SUBPAGE_CLICKTHROUGH
      - SHOWCASE_SUBPIN_CLICKTHROUGH
      - SHOWCASE_SUBPAGE_IMPRESSION
      - SHOWCASE_SUBPIN_IMPRESSION
      - SHOWCASE_SUBPAGE_SWIPE_LEFT
      - SHOWCASE_SUBPAGE_SWIPE_RIGHT
      - SHOWCASE_SUBPIN_SWIPE_LEFT
      - SHOWCASE_SUBPIN_SWIPE_RIGHT
      - SHOWCASE_SUBPAGE_REPIN
      - SHOWCASE_SUBPIN_REPIN
      - SHOWCASE_SUBPAGE_CLOSEUP
      - SHOWCASE_CARD_THUMBNAIL_SWIPE_FORWARD
      - SHOWCASE_CARD_THUMBNAIL_SWIPE_BACKWARD
      - SHOWCASE_AVERAGE_SUBPAGE_CLOSEUP_PER_SESSION
      - TOTAL_CHECKOUT_CONVERSION_RATE
      - TOTAL_VIEW_CATEGORY_CONVERSION_RATE
      - TOTAL_ADD_TO_CART_CONVERSION_RATE
      - TOTAL_SIGNUP_CONVERSION_RATE
      - TOTAL_PAGE_VISIT_CONVERSION_RATE
      - TOTAL_LEAD_CONVERSION_RATE
      - TOTAL_SEARCH_CONVERSION_RATE
      - TOTAL_WATCH_VIDEO_CONVERSION_RATE
      - TOTAL_UNKNOWN_CONVERSION_RATE
      - TOTAL_CUSTOM_CONVERSION_RATE
      - STANDARD_AD_FEED_ITEM_ID
    ReportingTimeZone:
      type: string
      description: |-
        <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Closed beta</a>
        Specify the timezone to be applied for the reporting.
      example: PINTEREST_TIME_ZONE
      enum:
      - PINTEREST_TIME_ZONE
      - AD_ACCOUNT_TIME_ZONE
    ResourceIdToRoles:
      description: |
        A string representing a json object mapping a resource id to a list of business roles.
      type: string
      example: '{"549760723247": ["ANALYST"], "549760723248": ["ANALYST","ADMIN"]}'
    RespondToInvitesResponseArray:
      type: object
      properties:
        items:
          type: array
          description: List of invite/request accept/decline status. If there is an
            error, an exception object will be returned. If the invite/request was
            successfully accepted/declined, an invite object will be returned.
          items:
            type: object
            properties:
              exception:
                $ref: '#/components/schemas/InviteExceptionResponse'
              invite:
                description: An invite object for the invite/request that was successfully
                  accepted/declined. Will only be provided if the an invite/request
                  is successfully created.
                $ref: '#/components/schemas/BaseInviteDataResponse'
    Role:
      type: string
      description: An internal role type used on business access, EMPLOYEE, ADMIN.
      example: ADMIN
      enum:
      - UNKNOWN
      - OWNER
      - ADMIN
      - ANALYST
      - SOS_READER
      - FINANCE_MANAGER
      - FINANCE_EDIT
      - FINANCE_VIEW
      - AUDIENCE_MANAGER
      - CAMPAIGN_MANAGER
      - CATALOGS_MANAGER
      - CATALOGS_VIEWER
      - RESTRICTED_OWNER
      - PROFILE_MANAGER
      - PROFILE_PUBLISHER
      - RESOURCE_PINNER_LIST_OWNER
      - RESOURCE_PINNER_LIST_READER
      - BIZ_PINNER_LIST_SHARER
      - RESOURCE_CONVERSION_TAGS_READER
    SSIOAccountAddress:
      type: object
      properties:
        display:
          description: Address display
          example: 475 Brannan Street, San Francisco, CA 94103
          type: string
        purpose:
          description: Purpose for which the address is used, usually Billing or Businness
          example: Billing
          type: string
        address_id:
          description: Salesforce id for address
          example: a1C1N000004MUrLUAW
          type: string
        order_legal_entity:
          description: Legal entity for this insertion order
          example: PIN US OU
          type: string
    SSIOAccountItem:
      type: object
      properties:
        id:
          description: Salesforce id for billto_info
          example: 0011N00001LW8kAQAT
          type: string
        io_terms_id:
          description: Salesforce id for IO Terms and Conditions
          example: a2S1N000000bKHgUAM
          type: string
        io_terms:
          description: Salesforce text for IO Terms and Conditions
          example: The IO is governed by the terms available at https://business.pinterest.com/en/pinterest-advertising-services-agreement/.
            If a budget is listed on this IO, the parties agree that Advertiser (or
            if applicable, its Agency) may apply any of the budget to any auction
            bid type or ad product. Price will be determined by auction closing price,
            plus any applicable non-auction fees. The terms of the Agreement supersede
            any terms on this IO. ANY ADDITIONAL TERMS AND CONDITIONS ON THIS IO ARE
            NULL AND VOID.
          type: string
        us_terms_id:
          description: Salesforce id for US Terms and Conditions
          example: a2S1N000000bKIOUA2
          type: string
        us_terms:
          description: Salesforce text for US Terms and Conditions
          example: This Insertion Order ("IO") is subject to the Pinterest Addendum
            To IAB Standard Terms and Conditions for Internet Advertising For Media
            Buys One Year or Less (Version 3.0), as executed by Pinterest, Inc. and
            GroupM Worldwide LLC on May 7, 2014 and Amendment No. 1 to Pinterest Addendum
            to IAB Standard Terms and Conditions for Internet Advertising For Media
            Buys One Year or Less (Version 3.0) as executed by Pinterest, Inc. and
            GroupM Worldwide LLC on August 20, 2015. The parties agree that Agency
            may apply any of the budget listed on this IO to any auction bid type
            or ad product. Price will be determined by auction closing price, plus
            any applicable non-auction fees.The terms of the Addendum supersede any
            terms on this IO. ANY ADDITIONAL TERMS AND CONDITIONS ON THIS IO ARE NULL
            AND VOID.
          type: string
        row_terms_id:
          description: Salesforce id for Rest of the World Terms and Conditions
          example: a2S1N000000bKHhUAM
          type: string
        row_terms:
          description: Salesforce text for Rest of the World Terms and Conditions
          example: "The IO is governed by the terms available at\r\nhttps://business.pinterest.com/en-gb/pinterest-advertising-services-agreement"
          type: string
        io_type:
          description: Insertion Order Type - Pinterest Paper or Agency Paper
          example: Pinterest Paper
          type: string
        addresses:
          description: Address information that is associated with this account.
          type: array
          items:
            $ref: '#/components/schemas/SSIOAccountAddress'
    SSIOAccountPMPName:
      type: object
      properties:
        name:
          description: Display name
          example: Bidalgo
          type: string
        id:
          description: Salesforce id for PMP
          example: 0011N00001LW2aSQAT
          type: string
    SSIOAccountResponse:
      type: object
      properties:
        eligible:
          description: Advertiser eligible to create order lines
          example: true
          type: boolean
        can_edit:
          description: Advertiser eligible to update order lines
          example: true
          type: boolean
        billto_infos:
          type: array
          description: An array of Salesforce account information that includes address,
            io terms, etc.
          items:
            $ref: '#/components/schemas/SSIOAccountItem'
        currency:
          type: string
          example: USD
        pmp_names:
          type: array
          items:
            $ref: '#/components/schemas/SSIOAccountPMPName'
        error:
          description: Error indicator from Salesforce which could be "No Error"
          example: No Error
          type: string
    SSIOCreateInsertionOrderRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/SSIOInsertionOrderCommon'
      - type: object
        required:
        - order_line_type
        - start_date
        - po_number
        - pmp_id
        - order_name
        - media_contact_firstname
        - media_contact_lastname
        - media_contact_email
        - currency_info
        - billto_company_id
        - billto_business_address_id
        - billto_billing_address_id
        - billing_contact_firstname
        - billing_contact_lastname
        - billing_contact_email
        - accepted_terms_id
        properties:
          accepted_terms_time:
            description: The UTC timestamp (to the nearest sec) of when terms were
              accepted
            type: integer
          pmp_id:
            description: The pmp id
            type: string
          order_name:
            description: The order name
            type: string
          order_line_type:
            type: string
            description: Type can be Budget or Perpetual
            enum:
            - BUDGET
            - PERPETUALS
          accepted_terms_id:
            description: The SFDC id for the terms
            type: string
          billto_company_id:
            description: The bill-to company id
            type: string
          billto_business_address_id:
            description: The bill-to business address id
            type: string
          billto_billing_address_id:
            description: The bill-to billing address id
            type: string
          estimated_monthly_spend:
            description: If Ongoing (perpetual) order line, the estimated monthly
              spend
            type: number
          currency_info:
            $ref: '#/components/schemas/Currency'
    SSIOCreateInsertionOrderResponse:
      type: object
      properties:
        pin_order_id:
          description: Salesforce order id
          type: string
    SSIOEditInsertionOrderRequest:
      type: object
      allOf:
      - $ref: '#/components/schemas/SSIOInsertionOrderCommon'
      - type: object
        properties:
          oracle_line_id:
            description: LineId in the Oracle DB
            type: string
          salesforce_order_id:
            description: OrderId in SFDC
            type: string
          salesforce_order_line_id:
            description: OrderLineId in SFDC
            type: string
          ads_manager_order_line_id:
            description: Ads manager OrderLineId
            type: string
    SSIOEditInsertionOrderResponse:
      type: object
      properties:
        pin_order_id:
          description: Salesforce order id
          type: string
    SSIOInsertionOrderCommon:
      type: object
      properties:
        start_date:
          description: 'Starting date of time period. Format: YYYY-MM-DD'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
          example: '2020-12-20'
        end_date:
          description: 'End date of time period. Format: YYYY-MM-DD'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})$
          example: '2020-12-20'
        po_number:
          description: The po number
          type: string
        budget_amount:
          type: number
          description: If Budget order line, the budget amount.
          example: 5000000
        billing_contact_firstname:
          description: The billing contact first name
          type: string
        billing_contact_lastname:
          description: The billing contact last name
          type: string
        billing_contact_email:
          description: The billing contact email
          example: test@example
          type: string
        media_contact_firstname:
          description: The media contact first name
          type: string
        media_contact_lastname:
          description: The media contact last name
          type: string
        media_contact_email:
          description: The media contact email
          example: test@example
          type: string
        agency_link:
          description: URL link for agency
          type: string
        user_email:
          description: The email of user submitting the insertion order
          example: test@example
          type: string
    SSIOInsertionOrderStatus:
      type: object
      properties:
        pin_order_id:
          description: Salesforce order id
          example: 0Q01N0000015hekSAB
          type: string
        status:
          description: Salesforce insertion order status
          example: Approved
          type: string
        creation_time:
          description: Salesforce insertion order creation time
          example: '2017-06-21T23:11:11.000Z'
          type: string
          nullable: true
    SSIOInsertionOrderStatusResponse:
      allOf:
      - $ref: '#/components/schemas/SSIOInsertionOrderStatus'
      - type: object
    SSIOOrderLine:
      type: object
      properties:
        salesforce_order_line_id:
          description: OrderLineId in SFDC
          type: string
          nullable: true
        ads_manager_order_line_id:
          description: Ads manager OrderLineId
          type: string
          nullable: true
        pin_order_id:
          description: The pin order id associated with the order line in SFDC
          type: string
          nullable: true
        last_modified_date_time:
          description: Last modified date.
          example: '2020-10-06T13:07:04.000Z'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}).(\d{3})Z$
          nullable: true
        start_date:
          description: Start date of the order line.
          example: '2018-03-01'
          type: string
          format: date
          nullable: true
        end_date:
          description: End date of the order line.
          example: '2020-10-05'
          type: string
          format: date
          nullable: true
        bill_to_company_name:
          description: Bill To Company name
          example: Home Depot Inc.
          type: string
          nullable: true
        billing_contact_firstname:
          description: Billing contact first name
          example: Mary
          type: string
          nullable: true
        billing_contact_lastname:
          description: Billing contact last name
          example: Smith
          type: string
          nullable: true
        billing_contact_email:
          description: Billing contact email
          example: mail@test.com
          type: string
          nullable: true
        media_contact_email:
          description: Billing media email
          example: mail@test.com
          type: string
          nullable: true
        media_contact_firstname:
          description: Billing contact first name
          example: John
          type: string
          nullable: true
        media_contact_lastname:
          description: Billing contact first name
          example: Doe
          type: string
          nullable: true
        currency_info:
          $ref: '#/components/schemas/Currency'
          nullable: true
        agency_link:
          description: Agency link
          example: ''
          type: string
          nullable: true
        po_number:
          description: The po number
          type: string
          nullable: true
        order_name:
          description: The order name
          type: string
          nullable: true
        pmp_name:
          description: The Pinterest marketing partner name
          type: string
          nullable: true
        accepted_terms_id:
          description: The SFDC id for the terms
          type: string
          nullable: true
        accepted_terms_time:
          description: The UTC timestamp (to the nearest sec) of when terms were accepted
          example: '2020-10-06T13:07:04.000Z'
          type: string
          pattern: ^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}).(\d{3})Z$
          nullable: true
        budget_amount:
          type: number
          description: If Budget order line, the budget amount.
          example: 5000000
          nullable: true
        estimated_monthly_spend:
          description: If Ongoing (perpetual) order line, the estimated monthly spend
          type: number
          nullable: true
    SharedAudienceAccount:
      type: object
      properties:
        account_id:
          description: Account ID (ad account or business ID).
          example: '549755885175'
          type: string
          pattern: ^\d+$
        account_name:
          description: Account name.
          example: Home Depot USA
          type: string
        account_type:
          type: string
          description: account type
          enum:
          - AD_ACCOUNT
          - BUSINESS_ACCOUNT
        shared_on_timestamp:
          description: Epoch timestamp in seconds for the shared audience event
          example: 1677003860
          type: integer
      required:
      - account_id
      - account_name
      - account_type
      - shared_on_timestamp
    SingleInterestTargetingOptionResponse:
      title: SingleInterestTargetingOptionData
      type: object
      properties:
        id:
          type: string
          title: id
          pattern: \d+
          example: '945391946569'
        name:
          type: string
          title: name
          example: Dress
        child_interests:
          type: array
          title: child_interests
          items:
            type: string
        level:
          type: integer
          title: level
          example: 2
    TargetingAdvertiserCountry:
      type: string
      description: Advertiser's ISO two character country code.
      example: US
      nullable: true
      enum:
      - US
      - GB
      - CA
      - IE
      - AU
      - NZ
      - FR
      - SE
      - IL
      - DE
      - AT
      - IT
      - ES
      - NL
      - BE
      - PT
      - CH
      - HK
      - JP
      - KR
      - SG
      - 'NO'
      - DK
      - FI
      - CY
      - LU
      - MT
      - PL
      - RO
      - HU
      - CZ
      - GR
      - SK
      - BR
      - MX
      - AR
      - CL
      - CO
    TargetingOptionResponse:
      title: TargetingOptionResponse
      type: array
      nullable: true
      items:
        type: object
        example:
          '36313': 'Australia: Moreton Bay - North'
          '124735': 'Canada: North Battleford'
    TargetingSpec:
      description: Ad group targeting specification defining the ad group target audience.
        For example, `{"APPTYPE":["iphone"], "GENDER":["male"], "LOCALE":["en-US"],
        "LOCATION":["501"], "AGE_BUCKET":["25-34"]}`
      type: object
      properties:
        AGE_BUCKET:
          type: array
          nullable: true
          description: Age ranges. If the AGE_BUCKET field is missing, the default
            behavior in terms of ad delivery is that **All age buckets** will be targeted.
          example:
          - 35-44
          - 50-54
          items:
            type: string
            enum:
            - 18-24
            - 19+
            - 20+
            - 21+
            - 25-34
            - 35-44
            - 45-49
            - 50-54
            - 55-64
            - 65+
        APPTYPE:
          type: array
          nullable: true
          description: Allowed devices. If the APPTYPE field is missing, the default
            behavior in terms of ad delivery is that **All devices/apptypes** will
            be targeted.
          example:
          - ipad
          - iphone
          items:
            type: string
            enum:
            - android_mobile
            - android_tablet
            - ipad
            - iphone
            - web
            - web_mobile
        AUDIENCE_EXCLUDE:
          type: array
          nullable: true
          description: 'Excluded customer list IDs. Used to drive new customer acquisition
            goals. For example: ["2542620905475"]. Audience lists need to have at
            least 100 people with Pinterest accounts in them. If the AUDIENCE_EXCLUDE
            field is missing, the default behavior in terms of ad delivery is that
            **No users will be excluded**.'
          items:
            type: string
            pattern: ^\d+$
            minItems: 100
        AUDIENCE_INCLUDE:
          type: array
          nullable: true
          description: 'Targeted customer list IDs. For example: ["2542620905473"].
            Audience lists need to have at least 100 people with Pinterest accounts
            in them Audience lists need to have at least 100 people with Pinterest
            accounts in them. If the AUDIENCE_INCLUDE field is missing, the default
            behavior in terms of ad delivery is that **All users will be included**.'
          items:
            type: string
            pattern: ^\d+$
            minItems: 100
        GENDER:
          type: array
          nullable: true
          description: 'Targeted genders. Values: ["unknown","male","female"]. If
            the GENDER field is missing, the default behavior in terms of ad delivery
            is that **All genders will be targeted**.'
          items:
            type: string
            enum:
            - unknown
            - male
            - female
        GEO:
          type: array
          nullable: true
          description: Location region codes, e.g., "BE-VOV" (East Flanders, Belgium)
            For complete list, <a href="https://help.pinterest.com/sub/helpcenter/partner/pinterest_location_targeting_codes.xlsx"
            target="_blank">click here</a> or postal codes, e.g., "US-94107". Use
            either region codes or postal codes but not both. At least one of LOCATION
            or GEO must be specified. If the GEO field is missing, then only LOCATION
            values will be targeted (see LOCATION field below).
          items:
            type: string
        INTEREST:
          type: array
          description: Array of interest object IDs. If the INTEREST field is missing,
            the default behavior in terms of ad delivery is that **All interests will
            be targeted**.
          items:
            type: string
        LOCALE:
          type: array
          nullable: true
          description: 24 ISO 639-1 two-letter language codes. If the LOCALE field
            is not included in the request, all languages are targeted.
          items:
            type: string
        LOCATION:
          type: array
          nullable: true
          description: 22 ISO Alpha 2 two letter country codes or US Nielsen DMA (Designated
            Market Area) codes (location region codes) (e.g., ["US", "807"]). For
            complete list, click here. Location-Country and Location-Metro codes apply.
            At least one of LOCATION or GEO must be specified. If the LOCATION field
            is missing, then only GEO values will be targeted (see GEO field above).
          items:
            type: string
        SHOPPING_RETARGETING:
          type: array
          nullable: true
          description: "Array of object: lookback_window\t[Integer]: Number of days\
            \ ago to start lookback timeframe for dynamic retargeting tag_types [Array\
            \ of integer]: Event types to target for dynamic retargeting exclusion_window\
            \ [Integer]: Number of days ago to stop lookback timeframe for dynamic\
            \ retargeting"
          items:
            type: object
            example:
              lookback_window: 30
              exclusion_window: 14
              tag_types:
              - 0
              - 6
            properties:
              lookback_window:
                description: Number of days ago to start lookback timeframe for dynamic
                  retargeting
                example: 30
                title: lookback_window
                type: integer
              tag_types:
                description: Event types to target for dynamic retargeting
                example:
                - 0
                - 6
                items:
                  type: integer
                title: tag_types
                type: array
              exclusion_window:
                description: Number of days ago to stop lookback timeframe for dynamic
                  retargeting
                example: 14
                title: exclusion_window
                type: integer
            title: TargetingSpec_SHOPPING_RETARGETING
        TARGETING_STRATEGY:
          type: array
          nullable: true
          description: ''
          items:
            enum:
            - CHOOSE_YOUR_OWN
            - FIND_NEW_CUSTOMERS
            - RECONNECT_WITH_USERS
    TargetingTemplateAudienceSizing:
      type: object
      nullable: true
      description: 'Gets an audience size estimate for a set of given targeting spec
        data. <p>Returns:</p> An object containing an audience size estimate that
        has a reach estimate (number of unique users) against the given targeting
        template. This by default provides a monthly estimate. '
      example:
        reach_estimate:
          estimate: 63492000
          lower_bound: 47619000
          upper_bound: 79365000
      properties:
        reach_estimate:
          type: object
          properties:
            estimate:
              example: 63492000
              type: integer
              format: int64
            lower_bound:
              example: 47619000
              type: integer
              format: int64
            upper_bound:
              example: 79365000
              type: integer
              format: int64
    TargetingTemplateCommon:
      type: object
      properties:
        name:
          type: string
          example: Gaming
          description: targeting template name
        auto_targeting_enabled:
          type: boolean
          default: true
          description: Enable auto-targeting for ad group. Also known as <a href="https://help.pinterest.com/en/business/article/expanded-targeting"
            target="_blank">"expanded targeting"</a>.
        targeting_attributes:
          $ref: '#/components/schemas/TargetingSpec'
        placement_group:
          $ref: '#/components/schemas/PlacementGroupType'
        keywords:
          type: array
          example:
          - value: cats
            match_type: EXACT_NEGATIVE
          items:
            $ref: '#/components/schemas/TargetingTemplateKeyword'
        tracking_urls:
          $ref: '#/components/schemas/TrackingUrls'
    TargetingTemplateCreate:
      type: object
      allOf:
      - $ref: '#/components/schemas/TargetingTemplateCommon'
      - type: object
        required:
        - name
        - targeting_attributes
        properties:
          name:
            type: string
            example: Gaming
            description: Name of targeting template.
          targeting_attributes:
            $ref: '#/components/schemas/TargetingSpec'
    TargetingTemplateKeyword:
      type: object
      properties:
        match_type:
          $ref: '#/components/schemas/MatchType'
        value:
          type: string
          description: The keyword targeting (120 chars max).
          example: couples halloween costumes
    TargetingTemplateGetResponseData:
      type: object
      allOf:
      - $ref: '#/components/schemas/TargetingTemplateResponseData'
      - type: object
        title: TargetingTemplateGetResponseData
        properties:
          valid:
            nullable: true
            description: Inform if the targeting template is valid (ex. would be false
              if has revoked audience)
            type: boolean
            example: true
    TargetingTemplateResponseData:
      type: object
      allOf:
      - $ref: '#/components/schemas/TargetingTemplateCommon'
      - type: object
        title: TargetingTemplateResponseData
        properties:
          id:
            description: Targeting template ID.
            example: '643'
            type: string
            pattern: ^\d+$
          created_time:
            description: Targeting template created time. Unix timestamp in seconds.
            example: 1432744744
            title: created_time
            type: integer
          updated_time:
            description: Targeting template updated time.Unix timestamp in seconds.
            example: 1432744744
            title: updated_time
            type: integer
          ad_account_id:
            description: The ID of the advertiser that this targeting template belongs
              to.
            example: '549755885175'
            type: string
            pattern: ^\d+$
          status:
            type: string
            description: Indicate targeting template is active or Deleted
            allOf:
            - type: string
              description: Indicate targeting template is active or Deleted
              example: ACTIVE
              default: ACTIVE
              enum:
              - ACTIVE
              - DELETED
          sizing:
            $ref: '#/components/schemas/TargetingTemplateAudienceSizing'
    TargetingTemplateUpdateRequest:
      required:
      - operation_type
      - id
      type: object
      properties:
        operation_type:
          enum:
          - REMOVE
          type: string
        id:
          description: Targeting template ID
          example: '643'
          type: string
          pattern: ^\d+$
    TargetingTypeFilter:
      type: object
      properties:
        targeting_types:
          type: array
          description: List of targeting types. Requires `level` to be a value ending
            in `_TARGETING`. ["AUDIENCE_MULTIPLIER"] is only available in CAMPAIGN_TARGETING
            level. ["MEDIA_TYPE"] is only available in PRODUCT_ITEM_TARGETING level.
            ["AGE_BUCKET_AND_GENDER"] is in BETA and not yet available to all users.
          items:
            type: string
            description: Reporting targeting type
            example: APPTYPE
            enum:
            - KEYWORD
            - APPTYPE
            - GENDER
            - LOCATION
            - PLACEMENT
            - COUNTRY
            - TARGETED_INTEREST
            - PINNER_INTEREST
            - AUDIENCE_INCLUDE
            - GEO
            - AGE_BUCKET
            - REGION
            - MEDIA_TYPE
            - AGE_BUCKET_AND_GENDER
            - AUDIENCE_MULTIPLIER
            - CREATIVE_ENHANCEMENTS
            - LOCAL_ADS_STORE_CODE
          maxItems: 5
          minItems: 1
    TemplateResponse:
      type: object
      description: Template fields
      properties:
        id:
          description: Template ID
          example: '6739202847590'
          type: string
        ad_account_id:
          description: ID of the Ad Account that owns the template
          example: '547664674848'
          type: string
        ad_account_ids:
          description: IDs of the Ad Accounts that have access to this template
          example:
          - '547664674848'
          type: array
          items:
            type: string
        user_id:
          description: ID of the user who created the template
          example: '784762938748396'
          type: string
        name:
          description: Template Name
          example: Week over week spend
          nullable: true
          type: string
        report_start_relative_days_in_past:
          description: The number of days prior to the day the report will be delivered
            at which the report will start
          example: 7
          type: number
        report_end_relative_days_in_past:
          description: The number of days prior to the day the report will be delivered
            at which the report will end
          example: 7
          type: number
        date_range:
          properties:
            dynamic_date_range:
              description: The dynamic date range of the template
              nullable: true
              example:
                range: YEAR_TO_DATE
                type: dynamic
              properties:
                type:
                  description: The date range type
                  example: dynamic
                  type: string
                range:
                  description: The dynamic range type
                  enum:
                  - YEAR_TO_DATE
                  - QUARTER_TO_DATE
                  - MONTH_TO_DATE
                  - LAST_MONTH
                  - LAST_QUARTER
                  example: YEAR_TO_DATE
                  type: string
              type: object
            relative_date_range:
              description: The relative date range of the template
              nullable: true
              example:
                end_days_in_past: 7
                type: relative
                start_days_in_past: 14
              properties:
                type:
                  description: The date range type
                  example: relative
                  type: string
                start_days_in_past:
                  description: The start date of the date range
                  example: 14
                  type: number
                end_days_in_past:
                  description: The end date of the date range
                  example: 7
                  type: number
              type: object
            absolute_date_range:
              description: The absolute date range of the template
              nullable: true
              example:
                end_date: 6.027456183070403
                type: absolute
                start_date: 0.8008281904610115
              properties:
                type:
                  description: The date range type
                  example: absolute
                  type: string
                start_date:
                  description: The start date of the date range
                  example: 0.8008281904610115
                  type: number
                end_date:
                  description: The end date of the date range
                  example: 6.027456183070403
                  type: number
              type: object
          type: object
        report_level:
          $ref: '#/components/schemas/MetricsReportingLevel'
        report_format:
          $ref: '#/components/schemas/DataOutputFormat'
        columns:
          description: A list of columns to be included in the report
          example:
          - SPEND_IN_DOLLAR
          items:
            type: string
            description: Reporting Columns (Internal)
            example: TOTAL_CONVERSIONS
            enum:
            - SPEND_IN_MICRO_DOLLAR
            - SPEND_IN_MICRO_US_DOLLAR
            - BONUS_SPEND_IN_MICRO_DOLLAR
            - BONUS_SPEND_IN_DOLLAR
            - ADS_CREDIT_SPEND_IN_MICRO_DOLLAR
            - ADS_CREDIT_SPEND_IN_DOLLAR
            - PAID_IMPRESSION
            - PAID_CLICKTHROUGH
            - SPEND_IN_DOLLAR
            - SPEND_IN_US_DOLLAR
            - CPC_IN_MICRO_DOLLAR
            - ECPC_IN_MICRO_DOLLAR
            - CPC_IN_DOLLAR
            - ECPC_IN_DOLLAR
            - CTR
            - ECTR
            - OUTBOUND_CTR
            - OUTBOUND_CTR_1
            - CPC_IN_MICRO_CURRENCY
            - CPW_IN_MICRO_DOLLAR
            - CPW_IN_DOLLAR
            - COST_PER_OUTBOUND_CLICK
            - AD_ONLY_PIN
            - CAMPAIGN_NAME
            - CAMPAIGN_STATUS
            - IS_CAMPAIGN_LEARNING_PHASE
            - DATE
            - DATE_AS_TIMESTAMP
            - BUDGET_IN_DOLLAR
            - AVAILABLE_BUDGET_IN_DOLLAR
            - TARGETING_TYPE
            - TARGETING_VALUE
            - TARGETING_VALUE_NAME
            - CAMPAIGN_BRAND_LABEL
            - PAID_EVENTS
            - BONUS_EVENTS
            - INSERTION
            - LEGACY_CAMPAIGN_ID
            - HBASE_ID
            - PIN_DESCRIPTION
            - CAMPAIGN_END_DATE
            - PIN_PROMOTION_STATUS
            - AD_STATUS
            - PIN_ID
            - CROSS_DEVICE_TYPE
            - INGESTION_SOURCE
            - SOURCE_PLATFORM
            - PIN_PROMOTION_IS_RUNNING
            - TOTAL_ENGAGEMENT
            - ENGAGEMENT_1
            - ENGAGEMENT_2
            - CPE_IN_MICRO_DOLLAR
            - ECPE_IN_MICRO_DOLLAR
            - CPE_IN_DOLLAR
            - ECPE_IN_DOLLAR
            - ENGAGEMENT_RATE
            - EENGAGEMENT_RATE
            - INTERNAL_ECPE_IN_MICRO_DOLLAR
            - INTERNAL_ECPE_IN_DOLLAR
            - ECPM_IN_MICRO_DOLLAR
            - ECPM_IN_DOLLAR
            - REPIN_RATE
            - REPIN_RATE_2
            - CTR_2
            - CAMPAIGN_ID
            - ADVERTISER_ID
            - AD_ACCOUNT_ID
            - ADVERTISER_OWNER_USER_ID
            - ADVERTISER_OWNER_USER_NAME
            - PIN_PROMOTION_ID
            - AD_ID
            - AD_GROUP_ID
            - KEYWORD_ID
            - KEYWORD_IS_DELETED
            - BRAND_SFDC_ACCOUNT_ID
            - CAMPAIGN_ACTION_TYPE
            - CAMPAIGN_BID_TYPE
            - CAMPAIGN_ENTITY_STATUS
            - CAMPAIGN_MANAGED_STATUS
            - CAMPAIGN_OBJECTIVE_TYPE
            - CPM_IN_MICRO_DOLLAR
            - CPM_IN_DOLLAR
            - BUDGET_TYPE
            - BUDGET_IN_LOCAL_CURRENCY
            - AD_GROUP_NAME
            - AD_GROUP_STATUS
            - AD_GROUP_END_DATE
            - AD_GROUP_BUDGET_TYPE
            - AD_GROUP_BUDGET_IN_LOCAL_CURRENCY
            - AD_GROUP_SUGGESTED_BUDGET_IN_LOCAL_CURRENCY
            - AD_GROUP_SUGGESTED_BONUS_BUDGET_IN_LOCAL_CURRENCY
            - AD_GROUP_ENTITY_STATUS
            - AD_GROUP_ACTION_TYPE
            - AD_GROUP_CONVERSION_LEARNING_MODE_TYPE
            - AD_GROUP_TARGET_CPA
            - AD_GROUP_BID_STRATEGY_TYPE
            - AD_GROUP_EXPERIMENT_NAME
            - AD_GROUP_EXPERIMENT_CELL
            - AD_GROUP_BID_MULTIPLIER
            - CAMPAIGN_WEB_CLOSEUP_WHITELISTED
            - PRODUCT_GROUP_ID
            - PRODUCT_GROUP_DEFINITION
            - PARENT_PRODUCT_GROUP_ID
            - PRODUCT_GROUP_TYPE
            - PRODUCT_GROUP_BID_IN_MICRO_CURRENCY
            - PRODUCT_GROUP_STATUS
            - PRODUCT_GROUP_ENTITY_STATUS
            - PRODUCT_GROUP_INCLUSION
            - PRODUCT_GROUP_CREATIVE_TYPE
            - PROMO_ID
            - PROMO_NAME
            - ITEM_ID
            - PRODUCT_ITEM_ID
            - INTERNAL_PRODUCT_ITEM_ID
            - INTERNAL_PRODUCT_ITEM_ID_STR
            - PRODUCT_ITEM_NAME
            - PRODUCT_ITEM_IMAGE_URL
            - PRODUCT_ITEM_PRICE
            - PRODUCT_ITEM_PRODUCT_URL
            - PRODUCT_ITEM_PIN_URL
            - PRODUCT_ITEM_BRAND
            - PRODUCT_ITEM_DESCRIPTION
            - PRODUCT_ITEM_SALE_PRICE
            - PRODUCT_ITEM_PRODUCT_TYPE
            - PRODUCT_ITEM_PRODUCT_CATEGORY
            - PRODUCT_ITEM_CAMPAIGN_NAME
            - PRODUCT_ITEM_AD_GROUP_NAME
            - ORDER_LINE_ID
            - ORDER_LINE_NAME
            - ORDER_LINE_PIN_REV_SHARE
            - ORDER_LINE_PAID_TYPE
            - SPEND_ORDER_LINE_ID
            - SPEND_ORDER_LINE_PAID_TYPE
            - CONVERSION_PRODUCT_ID
            - CONVERSION_PRODUCT_NAME
            - CONVERSION_PRODUCT_BRAND
            - CONVERSION_PRODUCT_CATEGORY
            - CONVERSION_PRODUCT_ID_GROUP
            - CLICKTHROUGH_1
            - REPIN_1
            - IMPRESSION_1
            - LIKE_1
            - SEND_1
            - FLAG_1
            - HIDE_1
            - INSERTION_1
            - IMPRESSION_1_GROSS
            - CLICKTHROUGH_1_GROSS
            - OUTBOUND_CLICK_1
            - CLICKTHROUGH_USER_1
            - REPIN_USER_1
            - IMPRESSION_USER_1
            - LIKE_USER_1
            - SEND_USER_1
            - FLAG_USER_1
            - HIDE_USER_1
            - INSERTION_USER_1
            - CLICKTHROUGH_2
            - REPIN_2
            - IMPRESSION_2
            - LIKE_2
            - SEND_2
            - FLAG_2
            - OUTBOUND_CLICK_2
            - CLICKTHROUGH_USER_2
            - REPIN_USER_2
            - IMPRESSION_USER_2
            - LIKE_USER_2
            - SEND_USER_2
            - FLAG_USER_2
            - TOTAL_CLICKTHROUGH
            - TOTAL_REPIN
            - TOTAL_IMPRESSION
            - TOTAL_LIKE
            - TOTAL_SEND
            - TOTAL_FLAG
            - TOTAL_IMPRESSION_USER
            - TOTAL_IMPRESSION_USER_HLL
            - TOTAL_IMPRESSION_FREQUENCY
            - TOTAL_IMPRESSION_FREQUENCY_HLL
            - TOTAL_OUTBOUND_CLICK
            - COST_PER_OUTBOUND_CLICK_IN_DOLLAR
            - COST_PER_OUTBOUND_CLICK_IN_DOLLAR_1
            - ENGAGEMENT_PAGE_VISIT_1
            - ENGAGEMENT_SIGNUP_1
            - ENGAGEMENT_CHECKOUT_1
            - ENGAGEMENT_CUSTOM_1
            - ENGAGEMENT_ADD_TO_CART_1
            - ENGAGEMENT_LEAD_1
            - ENGAGEMENT_SEARCH_1
            - ENGAGEMENT_WATCH_VIDEO_1
            - ENGAGEMENT_VIEW_CATEGORY_1
            - ENGAGEMENT_APP_INSTALL_1
            - ENGAGEMENT_UNKNOWN_1
            - ENGAGEMENT_ADD_PAYMENT_INFO_1
            - ENGAGEMENT_ADD_TO_WISHLIST_1
            - ENGAGEMENT_INITIATE_CHECKOUT_1
            - ENGAGEMENT_SUBSCRIBE_1
            - ENGAGEMENT_VIEW_CONTENT_1
            - CLICK_PAGE_VISIT_1
            - CLICK_SIGNUP_1
            - CLICK_CHECKOUT_1
            - CLICK_CUSTOM_1
            - CLICK_ADD_TO_CART_1
            - CLICK_LEAD_1
            - CLICK_SEARCH_1
            - CLICK_WATCH_VIDEO_1
            - CLICK_VIEW_CATEGORY_1
            - CLICK_APP_INSTALL_1
            - CLICK_UNKNOWN_1
            - CLICK_ADD_PAYMENT_INFO_1
            - CLICK_ADD_TO_WISHLIST_1
            - CLICK_INITIATE_CHECKOUT_1
            - CLICK_SUBSCRIBE_1
            - CLICK_VIEW_CONTENT_1
            - VIEW_PAGE_VISIT_1
            - VIEW_SIGNUP_1
            - VIEW_CHECKOUT_1
            - VIEW_CUSTOM_1
            - VIEW_ADD_TO_CART_1
            - VIEW_LEAD_1
            - VIEW_SEARCH_1
            - VIEW_WATCH_VIDEO_1
            - VIEW_VIEW_CATEGORY_1
            - VIEW_APP_INSTALL_1
            - VIEW_UNKNOWN_1
            - VIEW_ADD_PAYMENT_INFO_1
            - VIEW_ADD_TO_WISHLIST_1
            - VIEW_INITIATE_CHECKOUT_1
            - VIEW_SUBSCRIBE_1
            - VIEW_VIEW_CONTENT_1
            - CONVERSIONS_1
            - ENGAGEMENT_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_SEARCH_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_APP_INSTALL_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_LEAD_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_SEARCH_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_APP_INSTALL_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_CUSTOM_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_LEAD_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_SEARCH_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_APP_INSTALL_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR_1
            - VIEW_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR_1
            - CONVERSIONS_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_PAGE_VISIT_QUANTITY_1
            - ENGAGEMENT_SIGNUP_QUANTITY_1
            - ENGAGEMENT_CHECKOUT_QUANTITY_1
            - ENGAGEMENT_CUSTOM_QUANTITY_1
            - ENGAGEMENT_ADD_TO_CART_QUANTITY_1
            - ENGAGEMENT_LEAD_QUANTITY_1
            - ENGAGEMENT_SEARCH_QUANTITY_1
            - ENGAGEMENT_WATCH_VIDEO_QUANTITY_1
            - ENGAGEMENT_VIEW_CATEGORY_QUANTITY_1
            - ENGAGEMENT_APP_INSTALL_QUANTITY_1
            - ENGAGEMENT_UNKNOWN_QUANTITY_1
            - ENGAGEMENT_ADD_PAYMENT_INFO_QUANTITY_1
            - ENGAGEMENT_ADD_TO_WISHLIST_QUANTITY_1
            - ENGAGEMENT_INITIATE_CHECKOUT_QUANTITY_1
            - ENGAGEMENT_SUBSCRIBE_QUANTITY_1
            - ENGAGEMENT_VIEW_CONTENT_QUANTITY_1
            - CLICK_PAGE_VISIT_QUANTITY_1
            - CLICK_SIGNUP_QUANTITY_1
            - CLICK_CHECKOUT_QUANTITY_1
            - CLICK_CUSTOM_QUANTITY_1
            - CLICK_ADD_TO_CART_QUANTITY_1
            - CLICK_LEAD_QUANTITY_1
            - CLICK_SEARCH_QUANTITY_1
            - CLICK_WATCH_VIDEO_QUANTITY_1
            - CLICK_VIEW_CATEGORY_QUANTITY_1
            - CLICK_APP_INSTALL_QUANTITY_1
            - CLICK_UNKNOWN_QUANTITY_1
            - CLICK_ADD_PAYMENT_INFO_QUANTITY_1
            - CLICK_ADD_TO_WISHLIST_QUANTITY_1
            - CLICK_INITIATE_CHECKOUT_QUANTITY_1
            - CLICK_SUBSCRIBE_QUANTITY_1
            - CLICK_VIEW_CONTENT_QUANTITY_1
            - VIEW_PAGE_VISIT_QUANTITY_1
            - VIEW_SIGNUP_QUANTITY_1
            - VIEW_CHECKOUT_QUANTITY_1
            - VIEW_CUSTOM_QUANTITY_1
            - VIEW_ADD_TO_CART_QUANTITY_1
            - VIEW_LEAD_QUANTITY_1
            - VIEW_SEARCH_QUANTITY_1
            - VIEW_WATCH_VIDEO_QUANTITY_1
            - VIEW_VIEW_CATEGORY_QUANTITY_1
            - VIEW_APP_INSTALL_QUANTITY_1
            - VIEW_UNKNOWN_QUANTITY_1
            - VIEW_ADD_PAYMENT_INFO_QUANTITY_1
            - VIEW_ADD_TO_WISHLIST_QUANTITY_1
            - VIEW_INITIATE_CHECKOUT_QUANTITY_1
            - VIEW_SUBSCRIBE_QUANTITY_1
            - VIEW_VIEW_CONTENT_QUANTITY_1
            - CONVERSIONS_QUANTITY_1
            - ENGAGEMENT_PAGE_VISIT_2
            - ENGAGEMENT_SIGNUP_2
            - ENGAGEMENT_CHECKOUT_2
            - ENGAGEMENT_CUSTOM_2
            - ENGAGEMENT_ADD_TO_CART_2
            - ENGAGEMENT_LEAD_2
            - ENGAGEMENT_SEARCH_2
            - ENGAGEMENT_WATCH_VIDEO_2
            - ENGAGEMENT_VIEW_CATEGORY_2
            - ENGAGEMENT_APP_INSTALL_2
            - ENGAGEMENT_UNKNOWN_2
            - ENGAGEMENT_ADD_PAYMENT_INFO_2
            - ENGAGEMENT_ADD_TO_WISHLIST_2
            - ENGAGEMENT_INITIATE_CHECKOUT_2
            - ENGAGEMENT_SUBSCRIBE_2
            - ENGAGEMENT_VIEW_CONTENT_2
            - CLICK_PAGE_VISIT_2
            - CLICK_SIGNUP_2
            - CLICK_CHECKOUT_2
            - CLICK_CUSTOM_2
            - CLICK_ADD_TO_CART_2
            - CLICK_LEAD_2
            - CLICK_SEARCH_2
            - CLICK_WATCH_VIDEO_2
            - CLICK_VIEW_CATEGORY_2
            - CLICK_APP_INSTALL_2
            - CLICK_UNKNOWN_2
            - CLICK_ADD_PAYMENT_INFO_2
            - CLICK_ADD_TO_WISHLIST_2
            - CLICK_INITIATE_CHECKOUT_2
            - CLICK_SUBSCRIBE_2
            - CLICK_VIEW_CONTENT_2
            - VIEW_PAGE_VISIT_2
            - VIEW_SIGNUP_2
            - VIEW_CHECKOUT_2
            - VIEW_CUSTOM_2
            - VIEW_ADD_TO_CART_2
            - VIEW_LEAD_2
            - VIEW_SEARCH_2
            - VIEW_WATCH_VIDEO_2
            - VIEW_VIEW_CATEGORY_2
            - VIEW_APP_INSTALL_2
            - VIEW_UNKNOWN_2
            - VIEW_ADD_PAYMENT_INFO_2
            - VIEW_ADD_TO_WISHLIST_2
            - VIEW_INITIATE_CHECKOUT_2
            - VIEW_SUBSCRIBE_2
            - VIEW_VIEW_CONTENT_2
            - CONVERSIONS_2
            - ENGAGEMENT_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_SEARCH_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_APP_INSTALL_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_LEAD_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_SEARCH_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_APP_INSTALL_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR_2
            - CLICK_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_CUSTOM_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_LEAD_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_SEARCH_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_APP_INSTALL_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR_2
            - VIEW_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR_2
            - CONVERSIONS_VALUE_IN_MICRO_DOLLAR_2
            - ENGAGEMENT_PAGE_VISIT_QUANTITY_2
            - ENGAGEMENT_SIGNUP_QUANTITY_2
            - ENGAGEMENT_CHECKOUT_QUANTITY_2
            - ENGAGEMENT_CUSTOM_QUANTITY_2
            - ENGAGEMENT_ADD_TO_CART_QUANTITY_2
            - ENGAGEMENT_LEAD_QUANTITY_2
            - ENGAGEMENT_SEARCH_QUANTITY_2
            - ENGAGEMENT_WATCH_VIDEO_QUANTITY_2
            - ENGAGEMENT_VIEW_CATEGORY_QUANTITY_2
            - ENGAGEMENT_APP_INSTALL_QUANTITY_2
            - ENGAGEMENT_UNKNOWN_QUANTITY_2
            - ENGAGEMENT_ADD_PAYMENT_INFO_QUANTITY_2
            - ENGAGEMENT_ADD_TO_WISHLIST_QUANTITY_2
            - ENGAGEMENT_INITIATE_CHECKOUT_QUANTITY_2
            - ENGAGEMENT_SUBSCRIBE_QUANTITY_2
            - ENGAGEMENT_VIEW_CONTENT_QUANTITY_2
            - CLICK_PAGE_VISIT_QUANTITY_2
            - CLICK_SIGNUP_QUANTITY_2
            - CLICK_CHECKOUT_QUANTITY_2
            - CLICK_CUSTOM_QUANTITY_2
            - CLICK_ADD_TO_CART_QUANTITY_2
            - CLICK_LEAD_QUANTITY_2
            - CLICK_SEARCH_QUANTITY_2
            - CLICK_WATCH_VIDEO_QUANTITY_2
            - CLICK_VIEW_CATEGORY_QUANTITY_2
            - CLICK_APP_INSTALL_QUANTITY_2
            - CLICK_UNKNOWN_QUANTITY_2
            - CLICK_ADD_PAYMENT_INFO_QUANTITY_2
            - CLICK_ADD_TO_WISHLIST_QUANTITY_2
            - CLICK_INITIATE_CHECKOUT_QUANTITY_2
            - CLICK_SUBSCRIBE_QUANTITY_2
            - CLICK_VIEW_CONTENT_QUANTITY_2
            - VIEW_PAGE_VISIT_QUANTITY_2
            - VIEW_SIGNUP_QUANTITY_2
            - VIEW_CHECKOUT_QUANTITY_2
            - VIEW_CUSTOM_QUANTITY_2
            - VIEW_ADD_TO_CART_QUANTITY_2
            - VIEW_LEAD_QUANTITY_2
            - VIEW_SEARCH_QUANTITY_2
            - VIEW_WATCH_VIDEO_QUANTITY_2
            - VIEW_VIEW_CATEGORY_QUANTITY_2
            - VIEW_APP_INSTALL_QUANTITY_2
            - VIEW_UNKNOWN_QUANTITY_2
            - VIEW_ADD_PAYMENT_INFO_QUANTITY_2
            - VIEW_ADD_TO_WISHLIST_QUANTITY_2
            - VIEW_INITIATE_CHECKOUT_QUANTITY_2
            - VIEW_SUBSCRIBE_QUANTITY_2
            - VIEW_VIEW_CONTENT_QUANTITY_2
            - CONVERSIONS_QUANTITY_2
            - TOTAL_ENGAGEMENT_PAGE_VISIT
            - TOTAL_ENGAGEMENT_SIGNUP
            - TOTAL_ENGAGEMENT_CHECKOUT
            - TOTAL_ENGAGEMENT_CUSTOM
            - TOTAL_ENGAGEMENT_ADD_TO_CART
            - TOTAL_ENGAGEMENT_LEAD
            - TOTAL_ENGAGEMENT_SEARCH
            - TOTAL_ENGAGEMENT_WATCH_VIDEO
            - TOTAL_ENGAGEMENT_VIEW_CATEGORY
            - TOTAL_ENGAGEMENT_APP_INSTALL
            - TOTAL_ENGAGEMENT_UNKNOWN
            - TOTAL_ENGAGEMENT_ADD_PAYMENT_INFO
            - TOTAL_ENGAGEMENT_ADD_TO_WISHLIST
            - TOTAL_ENGAGEMENT_INITIATE_CHECKOUT
            - TOTAL_ENGAGEMENT_SUBSCRIBE
            - TOTAL_ENGAGEMENT_VIEW_CONTENT
            - TOTAL_CLICK_PAGE_VISIT
            - TOTAL_CLICK_SIGNUP
            - TOTAL_CLICK_CHECKOUT
            - TOTAL_CLICK_CUSTOM
            - TOTAL_CLICK_ADD_TO_CART
            - TOTAL_CLICK_LEAD
            - TOTAL_CLICK_SEARCH
            - TOTAL_CLICK_WATCH_VIDEO
            - TOTAL_CLICK_VIEW_CATEGORY
            - TOTAL_CLICK_APP_INSTALL
            - TOTAL_CLICK_UNKNOWN
            - TOTAL_CLICK_ADD_PAYMENT_INFO
            - TOTAL_CLICK_ADD_TO_WISHLIST
            - TOTAL_CLICK_INITIATE_CHECKOUT
            - TOTAL_CLICK_SUBSCRIBE
            - TOTAL_CLICK_VIEW_CONTENT
            - TOTAL_VIEW_PAGE_VISIT
            - TOTAL_VIEW_SIGNUP
            - TOTAL_VIEW_CHECKOUT
            - TOTAL_VIEW_CUSTOM
            - TOTAL_VIEW_ADD_TO_CART
            - TOTAL_VIEW_LEAD
            - TOTAL_VIEW_SEARCH
            - TOTAL_VIEW_WATCH_VIDEO
            - TOTAL_VIEW_VIEW_CATEGORY
            - TOTAL_VIEW_APP_INSTALL
            - TOTAL_VIEW_UNKNOWN
            - TOTAL_VIEW_ADD_PAYMENT_INFO
            - TOTAL_VIEW_ADD_TO_WISHLIST
            - TOTAL_VIEW_INITIATE_CHECKOUT
            - TOTAL_VIEW_SUBSCRIBE
            - TOTAL_VIEW_VIEW_CONTENT
            - TOTAL_CONVERSIONS
            - TOTAL_WEB_CONVERSIONS
            - TOTAL_INAPP_CONVERSIONS
            - TOTAL_OFFLINE_CONVERSIONS
            - TOTAL_ENGAGEMENT_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_PAGE_VISIT_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_ADD_TO_CART_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_LEAD_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_WATCH_VIDEO_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_VIEW_CATEGORY_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ENGAGEMENT_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_CLICK_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_PAGE_VISIT_VALUE_IN_DOLLAR
            - TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_ADD_TO_CART_VALUE_IN_DOLLAR
            - TOTAL_CLICK_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_LEAD_VALUE_IN_DOLLAR
            - TOTAL_CLICK_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_CLICK_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_WATCH_VIDEO_VALUE_IN_DOLLAR
            - TOTAL_CLICK_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_VIEW_CATEGORY_VALUE_IN_DOLLAR
            - TOTAL_CLICK_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_CLICK_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_CLICK_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_CLICK_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_CLICK_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CLICK_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_VIEW_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_PAGE_VISIT_VALUE_IN_DOLLAR
            - TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_VIEW_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_ADD_TO_CART_VALUE_IN_DOLLAR
            - TOTAL_VIEW_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_LEAD_VALUE_IN_DOLLAR
            - TOTAL_VIEW_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_VIEW_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_WATCH_VIDEO_VALUE_IN_DOLLAR
            - TOTAL_VIEW_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_VIEW_CATEGORY_VALUE_IN_DOLLAR
            - TOTAL_VIEW_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_VIEW_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_VIEW_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_VIEW_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_VIEW_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_CONVERSIONS_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CONVERSIONS_VALUE_IN_DOLLAR
            - TOTAL_ENGAGEMENT_PAGE_VISIT_QUANTITY
            - TOTAL_ENGAGEMENT_SIGNUP_QUANTITY
            - TOTAL_ENGAGEMENT_CHECKOUT_QUANTITY
            - TOTAL_ENGAGEMENT_CUSTOM_QUANTITY
            - TOTAL_ENGAGEMENT_ADD_TO_CART_QUANTITY
            - TOTAL_ENGAGEMENT_LEAD_QUANTITY
            - TOTAL_ENGAGEMENT_SEARCH_QUANTITY
            - TOTAL_ENGAGEMENT_WATCH_VIDEO_QUANTITY
            - TOTAL_ENGAGEMENT_VIEW_CATEGORY_QUANTITY
            - TOTAL_ENGAGEMENT_APP_INSTALL_QUANTITY
            - TOTAL_ENGAGEMENT_UNKNOWN_QUANTITY
            - TOTAL_ENGAGEMENT_ADD_PAYMENT_INFO_QUANTITY
            - TOTAL_ENGAGEMENT_ADD_TO_WISHLIST_QUANTITY
            - TOTAL_ENGAGEMENT_INITIATE_CHECKOUT_QUANTITY
            - TOTAL_ENGAGEMENT_SUBSCRIBE_QUANTITY
            - TOTAL_ENGAGEMENT_VIEW_CONTENT_QUANTITY
            - TOTAL_CLICK_PAGE_VISIT_QUANTITY
            - TOTAL_CLICK_SIGNUP_QUANTITY
            - TOTAL_CLICK_CHECKOUT_QUANTITY
            - TOTAL_CLICK_CUSTOM_QUANTITY
            - TOTAL_CLICK_ADD_TO_CART_QUANTITY
            - TOTAL_CLICK_LEAD_QUANTITY
            - TOTAL_CLICK_SEARCH_QUANTITY
            - TOTAL_CLICK_WATCH_VIDEO_QUANTITY
            - TOTAL_CLICK_VIEW_CATEGORY_QUANTITY
            - TOTAL_CLICK_APP_INSTALL_QUANTITY
            - TOTAL_CLICK_UNKNOWN_QUANTITY
            - TOTAL_CLICK_ADD_PAYMENT_INFO_QUANTITY
            - TOTAL_CLICK_ADD_TO_WISHLIST_QUANTITY
            - TOTAL_CLICK_INITIATE_CHECKOUT_QUANTITY
            - TOTAL_CLICK_SUBSCRIBE_QUANTITY
            - TOTAL_CLICK_VIEW_CONTENT_QUANTITY
            - TOTAL_VIEW_PAGE_VISIT_QUANTITY
            - TOTAL_VIEW_SIGNUP_QUANTITY
            - TOTAL_VIEW_CHECKOUT_QUANTITY
            - TOTAL_VIEW_CUSTOM_QUANTITY
            - TOTAL_VIEW_ADD_TO_CART_QUANTITY
            - TOTAL_VIEW_LEAD_QUANTITY
            - TOTAL_VIEW_SEARCH_QUANTITY
            - TOTAL_VIEW_WATCH_VIDEO_QUANTITY
            - TOTAL_VIEW_VIEW_CATEGORY_QUANTITY
            - TOTAL_VIEW_APP_INSTALL_QUANTITY
            - TOTAL_VIEW_UNKNOWN_QUANTITY
            - TOTAL_VIEW_ADD_PAYMENT_INFO_QUANTITY
            - TOTAL_VIEW_ADD_TO_WISHLIST_QUANTITY
            - TOTAL_VIEW_INITIATE_CHECKOUT_QUANTITY
            - TOTAL_VIEW_SUBSCRIBE_QUANTITY
            - TOTAL_VIEW_VIEW_CONTENT_QUANTITY
            - TOTAL_CONVERSIONS_QUANTITY
            - COST_PER_CONVERSION_IN_DOLLAR
            - TOTAL_WEB_SESSIONS
            - WEB_SESSIONS_1
            - WEB_SESSIONS_2
            - APP_INSTALLS_CPA_BILLABLE
            - APP_INSTALLS_CLICK
            - APP_INSTALLS_CLOSEUPREPIN
            - APP_INSTALLS_VIEW
            - APP_INSTALLS
            - APP_INSTALLS_ENGAGEMENT
            - APP_INSTALLS_CLICK_1
            - APP_INSTALLS_CLICK_2
            - APP_INSTALLS_VIEW_1
            - APP_INSTALLS_VIEW_2
            - APP_INSTALLS_ENGAGEMENT_1
            - APP_INSTALLS_ENGAGEMENT_2
            - APP_INSTALLS_1
            - APP_INSTALLS_2
            - CPI_IN_MICRO_DOLLAR
            - ECPI_IN_MICRO_DOLLAR
            - CPI_IN_DOLLAR
            - ECPI_IN_DOLLAR
            - ONSITE_CHECKOUTS_CPA_BILLABLE_1
            - ONSITE_CHECKOUTS_CPA_BILLABLE_2
            - ONSITE_CHECKOUTS_CPA_BILLABLE
            - ONSITE_CHECKOUTS_VALUE_1
            - ONSITE_CHECKOUTS_VALUE_2
            - ONSITE_CHECKOUTS_VALUE
            - ONSITE_CHECKOUTS_1
            - ONSITE_CHECKOUTS_2
            - ONSITE_CHECKOUTS
            - ONSITE_CHECKOUTS_VALUE_IN_MICRO_DOLLAR_1
            - ONSITE_CHECKOUTS_VALUE_IN_MICRO_DOLLAR_2
            - CONVERSION_RATE
            - AVERAGE_CHECKOUT_VALUE
            - RETURN_ON_ADVERTISER_SPEND
            - BUY_BUTTON_CLICKS_1
            - BUY_BUTTON_CLICKS_2
            - TOTAL_BUY_BUTTON_CLICKS
            - ORDER_DROPOFF_RATE
            - ONSITE_CHECKOUTS_VALUE_IN_MICRO_DOLLAR
            - ONSITE_CHECKOUTS_VALUE_IN_DOLLAR
            - PIN_PROMOTION_NAME
            - AD_NAME
            - LIFETIME_IMPRESSION_USER_1
            - PIN_PROMOTION_CAMPAIGN_ID
            - PIN_PROMOTION_CAMPAIGN_NAME
            - PIN_PROMOTION_CAMPAIGN_ACTION_TYPE
            - TOTAL_LIFETIME_IMPRESSION_USER
            - PIN_PROMOTION_CAMPAIGN_STATUS
            - PIN_PROMOTION_CAMPAIGN_MANAGED_STATUS
            - PIN_PROMOTION_CAMPAIGN_ENTITY_STATUS
            - PIN_PROMOTION_AD_GROUP_ID
            - PIN_PROMOTION_AD_GROUP_NAME
            - PIN_PROMOTION_AD_GROUP_STATUS
            - PIN_PROMOTION_AD_GROUP_ENTITY_STATUS
            - PIN_PROMOTION_CREATIVE_TYPE
            - PIN_PROMOTION_ENTITY_STATUS
            - PIN_PROMOTION_CREATIVE_TYPE_V2
            - PIN_PROMOTION_REVIEW_STATUS
            - AD_GROUP_CAMPAIGN_ACTION_TYPE
            - AD_GROUP_CAMPAIGN_ID
            - AD_GROUP_CAMPAIGN_NAME
            - AD_GROUP_CAMPAIGN_STATUS
            - AD_GROUP_CREATIVE_TYPE
            - AD_GROUP_CAMPAIGN_MANAGED_STATUS
            - AD_GROUP_CAMPAIGN_ENTITY_STATUS
            - AD_GROUP_START_DATE
            - CAMPAIGN_LIFETIME_SPEND_CAP
            - AD_GROUP_BID_IN_MICRO_CURRENCY
            - CAMPAIGN_AD_GROUP_START_DATE
            - CAMPAIGN_AD_GROUP_END_DATE
            - CAMPAIGN_NUMBER_OF_AD_GROUPS
            - AD_GROUP_NUMBER_OF_PIN_PROMOTIONS
            - TODAY_SPEND_IN_LOCAL_CURRENCY
            - TOTAL_LIFETIME_SPEND_IN_LOCAL_CURRENCY
            - BUDGET_UTILIZATION
            - AD_GROUP_OPTIMIZATION
            - INSERTION_ORDER
            - AD_GROUP_BONUS_BUDGET
            - FREQUENCY
            - CAMPAIGN_DAILY_SPEND_CAP
            - CAMPAIGN_CREATIVE_TYPE
            - AD_GROUP_PLACEMENT_GROUP_TYPE
            - AD_GROUP_IS_PREFETCH_ENABLED
            - CAMPAIGN_BUDGET_OPTIMIZATION
            - CAMPAIGN_START_DATE
            - IS_AUTOMATED_CAMPAIGN
            - IS_PREMIERE_CAMPAIGN
            - FLEXIBLE_DAILY_BUDGETS
            - IS_PERFORMANCE_PLUS_CAMPAIGN
            - IS_DCO_FORMAT_ENHANCMENT
            - PERCENT_CROSS_DEVICE_CONVERSIONS
            - PAGE_VISIT_PERCENT_CROSS_DEVICE_CONVERSIONS
            - SIGNUP_PERCENT_CROSS_DEVICE_CONVERSIONS
            - CHECKOUT_PERCENT_CROSS_DEVICE_CONVERSIONS
            - CUSTOM_PERCENT_CROSS_DEVICE_CONVERSIONS
            - ADD_TO_CART_PERCENT_CROSS_DEVICE_CONVERSIONS
            - LEAD_PERCENT_CROSS_DEVICE_CONVERSIONS
            - SEARCH_PERCENT_CROSS_DEVICE_CONVERSIONS
            - WATCH_VIDEO_PERCENT_CROSS_DEVICE_CONVERSIONS
            - VIEW_CATEGORY_PERCENT_CROSS_DEVICE_CONVERSIONS
            - APP_INSTALL_PERCENT_CROSS_DEVICE_CONVERSIONS
            - UNKNOWN_PERCENT_CROSS_DEVICE_CONVERSIONS
            - TOTAL_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_PAGE_VISIT_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_PAGE_VISIT_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_PAGE_VISIT_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_PAGE_VISIT_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_PAGE_VISIT_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_PAGE_VISIT_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_PAGE_VISIT_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_PAGE_VISIT_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_PAGE_VISIT_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_SIGNUP_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_SIGNUP_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_SIGNUP_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_SIGNUP_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_SIGNUP_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_SIGNUP_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_SIGNUP_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_SIGNUP_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_SIGNUP_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_CHECKOUT_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_CHECKOUT_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_CHECKOUT_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_CHECKOUT_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_CHECKOUT_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_CHECKOUT_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_CHECKOUT_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_CHECKOUT_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_CHECKOUT_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_CUSTOM_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_CUSTOM_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_CUSTOM_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_CUSTOM_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_CUSTOM_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_CUSTOM_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_CUSTOM_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_CUSTOM_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_CUSTOM_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_ADD_TO_CART_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_ADD_TO_CART_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_ADD_TO_CART_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_ADD_TO_CART_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_ADD_TO_CART_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_ADD_TO_CART_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_ADD_TO_CART_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_ADD_TO_CART_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_ADD_TO_CART_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_LEAD_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_LEAD_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_LEAD_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_LEAD_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_LEAD_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_LEAD_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_LEAD_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_LEAD_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_LEAD_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_SEARCH_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_SEARCH_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_SEARCH_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_SEARCH_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_SEARCH_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_SEARCH_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_SEARCH_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_SEARCH_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_SEARCH_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_WATCH_VIDEO_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_WATCH_VIDEO_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_WATCH_VIDEO_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_WATCH_VIDEO_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_WATCH_VIDEO_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_WATCH_VIDEO_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_WATCH_VIDEO_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_WATCH_VIDEO_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_WATCH_VIDEO_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_VIEW_CATEGORY_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_VIEW_CATEGORY_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_VIEW_CATEGORY_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_VIEW_CATEGORY_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_VIEW_CATEGORY_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_VIEW_CATEGORY_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_VIEW_CATEGORY_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_VIEW_CATEGORY_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_VIEW_CATEGORY_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_APP_INSTALL_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_APP_INSTALL_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_APP_INSTALL_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_APP_INSTALL_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_APP_INSTALL_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_APP_INSTALL_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_APP_INSTALL_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_APP_INSTALL_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_APP_INSTALL_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_UNKNOWN_DESKTOP_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_UNKNOWN_DESKTOP_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_UNKNOWN_DESKTOP_ACTION_TO_TABLET_CONVERSION
            - TOTAL_UNKNOWN_MOBILE_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_UNKNOWN_MOBILE_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_UNKNOWN_MOBILE_ACTION_TO_TABLET_CONVERSION
            - TOTAL_UNKNOWN_TABLET_ACTION_TO_DESKTOP_CONVERSION
            - TOTAL_UNKNOWN_TABLET_ACTION_TO_MOBILE_CONVERSION
            - TOTAL_UNKNOWN_TABLET_ACTION_TO_TABLET_CONVERSION
            - TOTAL_PAGE_VISIT
            - TOTAL_SIGNUP
            - TOTAL_CHECKOUT
            - TOTAL_CUSTOM
            - TOTAL_ADD_TO_CART
            - TOTAL_LEAD
            - TOTAL_SEARCH
            - TOTAL_WATCH_VIDEO
            - TOTAL_VIEW_CATEGORY
            - TOTAL_APP_INSTALL
            - TOTAL_UNKNOWN
            - TOTAL_ADD_PAYMENT_INFO
            - TOTAL_ADD_TO_WISHLIST
            - TOTAL_INITIATE_CHECKOUT
            - TOTAL_SUBSCRIBE
            - TOTAL_VIEW_CONTENT
            - TOTAL_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
            - TOTAL_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
            - TOTAL_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_LEAD_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_SEARCH_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - AVERAGE_PAGE_VISIT_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_SIGNUP_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_CHECKOUT_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_CUSTOM_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_ADD_TO_CART_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_LEAD_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_SEARCH_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_WATCH_VIDEO_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_VIEW_CATEGORY_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_UNKNOWN_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_ADD_PAYMENT_INFO_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_ADD_TO_WISHLIST_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_INITIATE_CHECKOUT_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_SUBSCRIBE_VALUE_IN_MICRO_US_DOLLAR
            - AVERAGE_VIEW_CONTENT_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_PAGE_VISIT_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_SIGNUP_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_CHECKOUT_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_CUSTOM_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_ADD_TO_CART_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_LEAD_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_SEARCH_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_WATCH_VIDEO_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_VIEW_CATEGORY_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_UNKNOWN_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_ADD_PAYMENT_INFO_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_ADD_TO_WISHLIST_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_INITIATE_CHECKOUT_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_SUBSCRIBE_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_VIEW_CONTENT_VALUE_IN_MICRO_US_DOLLAR
            - TOTAL_PAGE_VISIT_QUANTITY
            - TOTAL_SIGNUP_QUANTITY
            - TOTAL_CHECKOUT_QUANTITY
            - TOTAL_CUSTOM_QUANTITY
            - TOTAL_ADD_TO_CART_QUANTITY
            - TOTAL_LEAD_QUANTITY
            - TOTAL_SEARCH_QUANTITY
            - TOTAL_WATCH_VIDEO_QUANTITY
            - TOTAL_VIEW_CATEGORY_QUANTITY
            - TOTAL_APP_INSTALL_QUANTITY
            - TOTAL_UNKNOWN_QUANTITY
            - TOTAL_ADD_PAYMENT_INFO_QUANTITY
            - TOTAL_ADD_TO_WISHLIST_QUANTITY
            - TOTAL_INITIATE_CHECKOUT_QUANTITY
            - TOTAL_SUBSCRIBE_QUANTITY
            - TOTAL_VIEW_CONTENT_QUANTITY
            - TOTAL_PAGE_VISIT_VALUE_IN_DOLLAR
            - TOTAL_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_ADD_TO_CART_VALUE_IN_DOLLAR
            - TOTAL_LEAD_VALUE_IN_DOLLAR
            - TOTAL_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_WATCH_VIDEO_VALUE_IN_DOLLAR
            - TOTAL_VIEW_CATEGORY_VALUE_IN_DOLLAR
            - TOTAL_APP_INSTALL_VALUE_IN_DOLLAR
            - TOTAL_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_VIEW_CONTENT_VALUE_IN_DOLLAR
            - PAGE_VISIT_COST_PER_ACTION
            - SIGNUP_COST_PER_ACTION
            - CHECKOUT_COST_PER_ACTION
            - CUSTOM_COST_PER_ACTION
            - ADD_TO_CART_COST_PER_ACTION
            - LEAD_COST_PER_ACTION
            - SEARCH_COST_PER_ACTION
            - WATCH_VIDEO_COST_PER_ACTION
            - VIEW_CATEGORY_COST_PER_ACTION
            - APP_INSTALL_COST_PER_ACTION
            - UNKNOWN_COST_PER_ACTION
            - AD_GROUP_CPA_IN_MICRO_CURRENCY
            - ADD_PAYMENT_INFO_COST_PER_ACTION
            - ADD_TO_WISHLIST_COST_PER_ACTION
            - INITIATE_CHECKOUT_COST_PER_ACTION
            - SUBSCRIBE_COST_PER_ACTION
            - VIEW_CONTENT_COST_PER_ACTION
            - PAGE_VISIT_COST_PER_ACTION_IN_US_DOLLAR
            - SIGNUP_COST_PER_ACTION_IN_US_DOLLAR
            - CHECKOUT_COST_PER_ACTION_IN_US_DOLLAR
            - CUSTOM_COST_PER_ACTION_IN_US_DOLLAR
            - ADD_TO_CART_COST_PER_ACTION_IN_US_DOLLAR
            - LEAD_COST_PER_ACTION_IN_US_DOLLAR
            - SEARCH_COST_PER_ACTION_IN_US_DOLLAR
            - WATCH_VIDEO_COST_PER_ACTION_IN_US_DOLLAR
            - VIEW_CATEGORY_COST_PER_ACTION_IN_US_DOLLAR
            - UNKNOWN_COST_PER_ACTION_IN_US_DOLLAR
            - ADD_PAYMENT_INFO_COST_PER_ACTION_IN_US_DOLLAR
            - ADD_TO_WISHLIST_COST_PER_ACTION_IN_US_DOLLAR
            - INITIATE_CHECKOUT_COST_PER_ACTION_IN_US_DOLLAR
            - SUBSCRIBE_COST_PER_ACTION_IN_US_DOLLAR
            - VIEW_CONTENT_COST_PER_ACTION_IN_US_DOLLAR
            - PAGE_VISIT_ROAS
            - SIGNUP_ROAS
            - CHECKOUT_ROAS
            - CUSTOM_ROAS
            - ADD_TO_CART_ROAS
            - LEAD_ROAS
            - SEARCH_ROAS
            - WATCH_VIDEO_ROAS
            - VIEW_CATEGORY_ROAS
            - APP_INSTALL_ROAS
            - UNKNOWN_ROAS
            - ROAS
            - CLICK_ROAS
            - ENGAGEMENT_ROAS
            - VIEW_ROAS
            - ADD_PAYMENT_INFO_ROAS
            - ADD_TO_WISHLIST_ROAS
            - INITIATE_CHECKOUT_ROAS
            - SUBSCRIBE_ROAS
            - VIEW_CONTENT_ROAS
            - HOUR
            - BOARD_ENGAGEMENT
            - BOARD_INSERTION
            - BOARD_IMPRESSION
            - BOARD_FOLLOW
            - BOARD_SEND
            - BOARD_HIDE
            - PRODUCT_GROUP_CAMPAIGN_ID
            - PRODUCT_GROUP_CAMPAIGN_NAME
            - PRODUCT_GROUP_CAMPAIGN_ACTION_TYPE
            - PRODUCT_GROUP_CAMPAIGN_STATUS
            - PRODUCT_GROUP_CAMPAIGN_MANAGED_STATUS
            - PRODUCT_GROUP_AD_GROUP_ID
            - PRODUCT_GROUP_AD_GROUP_NAME
            - PRODUCT_GROUP_AD_GROUP_STATUS
            - PRODUCT_GROUP_AD_IMAGE_TAG
            - PRODUCT_GROUP_AD_VIDEO_TAG
            - PROMOTED_CATALOG_PRODUCT_GROUP_REFERENCE_ID
            - PROMOTED_CATALOG_PRODUCT_GROUP_REFERENCE_NAME
            - PROMOTED_CATALOG_PRODUCT_GROUP_ID
            - PROMOTED_CATALOG_PRODUCT_GROUP_BID_IN_MICRO_CURRENCY
            - PROMOTED_CATALOG_PRODUCT_GROUP_STATUS
            - PROMOTED_CATALOG_PRODUCT_GROUP_ENTITY_STATUS
            - PROMOTED_CATALOG_PRODUCT_GROUP_CAMPAIGN_ID
            - PROMOTED_CATALOG_PRODUCT_GROUP_CAMPAIGN_NAME
            - PROMOTED_CATALOG_PRODUCT_GROUP_CAMPAIGN_ACTION_TYPE
            - PROMOTED_CATALOG_PRODUCT_GROUP_CAMPAIGN_STATUS
            - PROMOTED_CATALOG_PRODUCT_GROUP_CAMPAIGN_MANAGED_STATUS
            - PROMOTED_CATALOG_PRODUCT_GROUP_AD_GROUP_ID
            - PROMOTED_CATALOG_PRODUCT_GROUP_AD_GROUP_NAME
            - PROMOTED_CATALOG_PRODUCT_GROUP_AD_GROUP_STATUS
            - PROMOTED_CATALOG_PRODUCT_GROUP_TRACKING_TEMPLATE_URL
            - PROMOTED_CATALOG_PRODUCT_GROUP_SELECTED_IMAGE_TAG
            - VIDEO_3SEC_VIEWS_1
            - VIDEO_P0_COMPLETE_1
            - VIDEO_P25_COMPLETE_1
            - VIDEO_P50_COMPLETE_1
            - VIDEO_P75_COMPLETE_1
            - VIDEO_P95_COMPLETE_1
            - VIDEO_P97_COMPLETE_1
            - VIDEO_P100_COMPLETE_1
            - VIDEO_P0_COMBINED_1
            - VIDEO_P25_COMBINED_1
            - VIDEO_P50_COMBINED_1
            - VIDEO_P75_COMBINED_1
            - VIDEO_P95_COMBINED_1
            - VIDEO_P97_COMBINED_1
            - VIDEO_P100_COMBINED_1
            - VIDEO_STARTS_PAID
            - VIDEO_STARTS_EARNED
            - TOTAL_VIDEO_STARTS
            - VIDEO_AVG_WATCHTIME_1
            - VIDEO_MRC_VIEWS_1
            - VIDEO_VIEW_RATE_1
            - VIDEO_3SEC_VIEWS_2
            - VIDEO_P0_COMPLETE_2
            - VIDEO_P25_COMPLETE_2
            - VIDEO_P50_COMPLETE_2
            - VIDEO_P75_COMPLETE_2
            - VIDEO_P95_COMPLETE_2
            - VIDEO_P97_COMPLETE_2
            - VIDEO_P100_COMPLETE_2
            - VIDEO_P0_COMBINED_2
            - VIDEO_P25_COMBINED_2
            - VIDEO_P50_COMBINED_2
            - VIDEO_P75_COMBINED_2
            - VIDEO_P95_COMBINED_2
            - VIDEO_P97_COMBINED_2
            - VIDEO_P100_COMBINED_2
            - VIDEO_AVG_WATCHTIME_2
            - VIDEO_MRC_VIEWS_2
            - VIDEO_VIEW_RATE_2
            - PAID_VIDEO_VIEW
            - PAID_VIDEO_IMPRESSION
            - PAID_VIDEO_VIEWABLE_RATE
            - VIDEO_LENGTH
            - VIDEO_SPEND_IN_MICRO_DOLLAR
            - VIDEO_SPEND_IN_DOLLAR
            - CPV_IN_MICRO_DOLLAR
            - CPV_IN_DOLLAR
            - CP3SV_IN_MICRO_DOLLAR
            - CP3SV_IN_DOLLAR
            - ECPV_IN_MICRO_DOLLAR
            - ECPV_IN_DOLLAR
            - ECP3SV_IN_MICRO_DOLLAR
            - ECP3SV_IN_DOLLAR
            - CPCV_IN_DOLLAR
            - CPCV_IN_MICRO_DOLLAR
            - ECPCV_IN_DOLLAR
            - ECPCV_IN_MICRO_DOLLAR
            - CPCV_P95_IN_DOLLAR
            - CPCV_P95_IN_MICRO_DOLLAR
            - ECPCV_P95_IN_DOLLAR
            - ECPCV_P95_IN_MICRO_DOLLAR
            - TOTAL_VIDEO_3SEC_VIEWS
            - TOTAL_VIDEO_P0_COMPLETE
            - TOTAL_VIDEO_P25_COMPLETE
            - TOTAL_VIDEO_P50_COMPLETE
            - TOTAL_VIDEO_P75_COMPLETE
            - TOTAL_VIDEO_P95_COMPLETE
            - TOTAL_VIDEO_P97_COMPLETE
            - TOTAL_VIDEO_P100_COMPLETE
            - TOTAL_VIDEO_P0_COMBINED
            - TOTAL_VIDEO_P25_COMBINED
            - TOTAL_VIDEO_P50_COMBINED
            - TOTAL_VIDEO_P75_COMBINED
            - TOTAL_VIDEO_P95_COMBINED
            - TOTAL_VIDEO_P97_COMBINED
            - TOTAL_VIDEO_P100_COMBINED
            - TOTAL_VIDEO_AVG_WATCHTIME
            - TOTAL_VIDEO_MRC_VIEWS
            - TOTAL_VIDEO_VIEW_RATE
            - VIDEO_V50_WATCHTIME_1
            - VIDEO_V50_WATCHTIME_2
            - TOTAL_VIDEO_V50_WATCHTIME
            - VIDEO_SUM_V50_WATCHTIME_IN_MILLISECOND_1
            - VIDEO_SUM_V50_WATCHTIME_IN_MILLISECOND_2
            - TOTAL_VIDEO_SUM_V50_WATCHTIME_IN_MILLISECOND
            - VIDEO_SUM_V50_WATCHTIME_IN_SECOND_1
            - VIDEO_SUM_V50_WATCHTIME_IN_SECOND_2
            - TOTAL_VIDEO_SUM_V50_WATCHTIME_IN_SECOND
            - VIDEO_AVG_WATCHTIME_IN_MILLISECOND_1
            - VIDEO_AVG_WATCHTIME_IN_MILLISECOND_2
            - TOTAL_VIDEO_AVG_WATCHTIME_IN_MILLISECOND
            - VIDEO_AVG_WATCHTIME_IN_SECOND_1
            - VIDEO_AVG_WATCHTIME_IN_SECOND_2
            - TOTAL_VIDEO_AVG_WATCHTIME_IN_SECOND
            - VIDEO_AVG_WATCHTIME_IN_SECOND_VIDEO_STARTS_PAID
            - VIDEO_AVG_WATCHTIME_IN_SECOND_VIDEO_STARTS_EARNED
            - TOTAL_VIDEO_AVG_WATCHTIME_IN_SECOND_VIDEO_STARTS
            - DELIVERY_STATUS_NO_FANOUT
            - DELIVERY_STATUS_WITH_FANOUT
            - KEYWORD_COMPETITION_BAND
            - KEYWORD_QUERY_VOLUME
            - KEYWORD_VALUE
            - KEYWORD_MATCH_TYPE
            - KEYWORD_BID_IN_MICRO_CURRENCY
            - KEYWORD_USER_QUERY
            - KEYWORD_SQR_KEYWORD_VALUE
            - KEYWORD_AD_GROUP_ID
            - KEYWORD_AD_GROUP_NAME
            - KEYWORD_CAMPAIGN_ID
            - KEYWORD_CAMPAIGN_NAME
            - KEYWORD_SEARCH_TERM_AD_GROUP_ID
            - KEYWORD_SEARCH_TERM_AD_GROUP_NAME
            - KEYWORD_SEARCH_TERM_CAMPAIGN_ID
            - KEYWORD_SEARCH_TERM_CAMPAIGN_NAME
            - NEGATIVE_KEYWORD_AD_GROUP_ID
            - NEGATIVE_KEYWORD_AD_GROUP_NAME
            - NEGATIVE_KEYWORD_CAMPAIGN_ID
            - NEGATIVE_KEYWORD_CAMPAIGN_NAME
            - ONE_TAP_V2_WEBSITE_VIEW_1
            - ONE_TAP_V2_WEBSITE_VIEW_2
            - TOTAL_ONE_TAP_V2_WEBSITE_VIEW
            - ONE_TAP_V2_WEBSITE_VIEW_USER_1
            - ONE_TAP_V2_WEBSITE_VIEW_USER_2
            - TOTAL_LANDING_PAGE_VIEWS
            - LANDING_PAGE_VIEWS_1
            - LANDING_PAGE_VIEWS_2
            - COST_PER_LANDING_PAGE_VIEW
            - LANDING_PAGE_VIEW_RATE
            - TOTAL_DESTINATION_VIEWS
            - DESTINATION_VIEWS_1
            - DESTINATION_VIEWS_2
            - COST_PER_DESTINATION_VIEW_IN_DOLLAR
            - COST_PER_DESTINATION_VIEW_IN_MICRO_DOLLAR
            - DESTINATION_VIEW_RATE
            - CAROUSEL_SLOT_INDEX
            - CAROUSEL_ID
            - CAROUSEL_SLOT_PROMOTION_ID
            - CAROUSEL_SLOT_IMPRESSION_1
            - CAROUSEL_SLOT_IMPRESSION_2
            - TOTAL_CAROUSEL_SLOT_IMPRESSION
            - CAROUSEL_SLOT_IMPRESSION_USER_1
            - CAROUSEL_SLOT_IMPRESSION_USER_2
            - CAROUSEL_SLOT_CLICKTHROUGH_1
            - CAROUSEL_SLOT_CLICKTHROUGH_2
            - TOTAL_CAROUSEL_SLOT_CLICKTHROUGH
            - CAROUSEL_SLOT_CLICKTHROUGH_USER_1
            - CAROUSEL_SLOT_CLICKTHROUGH_USER_2
            - CAROUSEL_SLOT_SIDESWIPE_1
            - CAROUSEL_SLOT_SIDESWIPE_2
            - TOTAL_CAROUSEL_SLOT_SIDESWIPE
            - CAROUSEL_SLOT_SIDESWIPE_USER_1
            - CAROUSEL_SLOT_SIDESWIPE_USER_2
            - CAROUSEL_SLOT_VIEW_WEBSITE_1
            - CAROUSEL_SLOT_VIEW_WEBSITE_2
            - TOTAL_CAROUSEL_SLOT_VIEW_WEBSITE
            - CAROUSEL_SLOT_VIEW_WEBSITE_USER_1
            - CAROUSEL_SLOT_VIEW_WEBSITE_USER_2
            - COLLECTION_PIN_ITEM_IMPRESSION_1
            - COLLECTION_PIN_ITEM_IMPRESSION_2
            - TOTAL_COLLECTION_PIN_ITEM_IMPRESSION
            - COLLECTION_PIN_ITEM_CLICKTHROUGH_1
            - COLLECTION_PIN_ITEM_CLICKTHROUGH_2
            - TOTAL_COLLECTION_PIN_ITEM_CLICKTHROUGH
            - HOLDOUT_EXPERIMENT
            - AD_GROUP_HOLDOUT_EXPERIMENT
            - PIN_PROMOTION_HOLDOUT_EXPERIMENT
            - PRODUCT_GROUP_HOLDOUT_EXPERIMENT
            - MULTI_OBJECTIVE_RESULT
            - MULTI_OBJECTIVE_COST
            - MULTI_OBJECTIVE_RESULT_DESCRIPTION
            - MULTI_OBJECTIVE_COST_DESCRIPTION
            - DATE_RANGE
            - DATE_RANGE_START
            - DATE_RANGE_END
            - REPORT_DATE_START
            - REPORT_DATE_END
            - PINNER_LIST_NAME
            - PINNER_LIST_TYPE
            - ORDER_VALUE
            - ORDER_QUANTITY
            - ADVERTISER_NAME
            - ADVERTISER_CURRENCY
            - TOTAL_REPIN_RATE
            - SPEND_YESTERDAY_IN_DOLLAR
            - PIN_PROMOTION_REJECTION_LABELS
            - PIN_PROMOTION_DESTINATION_URL
            - VIDEO_COMPLETION_RATE
            - CAMPAIGN_BOOKING_REFERENCE
            - WEB_CHECKOUT_COST_PER_ACTION
            - WEB_CHECKOUT_ROAS
            - TOTAL_WEB_CHECKOUT
            - TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_CHECKOUT
            - TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_CHECKOUT
            - TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_CHECKOUT
            - TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_DOLLAR
            - INAPP_CHECKOUT_COST_PER_ACTION
            - INAPP_CHECKOUT_ROAS
            - TOTAL_INAPP_CHECKOUT
            - TOTAL_INAPP_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_CHECKOUT
            - TOTAL_INAPP_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_CHECKOUT
            - TOTAL_INAPP_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_CHECKOUT
            - TOTAL_INAPP_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_CHECKOUT_VALUE_IN_DOLLAR
            - OFFLINE_CHECKOUT_COST_PER_ACTION
            - OFFLINE_CHECKOUT_ROAS
            - TOTAL_OFFLINE_CHECKOUT
            - TOTAL_OFFLINE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_CHECKOUT
            - TOTAL_OFFLINE_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_CHECKOUT
            - TOTAL_OFFLINE_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_CHECKOUT
            - TOTAL_OFFLINE_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_CHECKOUT_VALUE_IN_DOLLAR
            - PINTEREST_CHECKOUT_COST_PER_ACTION
            - PINTEREST_CHECKOUT_ROAS
            - TOTAL_PINTEREST_CHECKOUT
            - TOTAL_PINTEREST_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_PINTEREST_CHECKOUT_VALUE_IN_DOLLAR
            - WEB_ADD_TO_CART_COST_PER_ACTION
            - WEB_ADD_TO_CART_ROAS
            - TOTAL_WEB_ADD_TO_CART
            - TOTAL_WEB_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ADD_TO_CART_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_ADD_TO_CART
            - TOTAL_WEB_CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_ADD_TO_CART_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_ADD_TO_CART
            - TOTAL_WEB_ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_ADD_TO_CART
            - TOTAL_WEB_VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_ADD_TO_CART_VALUE_IN_DOLLAR
            - INAPP_ADD_TO_CART_COST_PER_ACTION
            - INAPP_ADD_TO_CART_ROAS
            - TOTAL_INAPP_ADD_TO_CART
            - TOTAL_INAPP_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ADD_TO_CART_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_ADD_TO_CART
            - TOTAL_INAPP_CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_ADD_TO_CART_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_ADD_TO_CART
            - TOTAL_INAPP_ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_ADD_TO_CART_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_ADD_TO_CART
            - TOTAL_INAPP_VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_ADD_TO_CART_VALUE_IN_DOLLAR
            - WEB_PAGE_VISIT_COST_PER_ACTION
            - WEB_PAGE_VISIT_ROAS
            - TOTAL_WEB_PAGE_VISIT
            - TOTAL_WEB_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_PAGE_VISIT_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_PAGE_VISIT
            - TOTAL_WEB_CLICK_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_PAGE_VISIT_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_PAGE_VISIT
            - TOTAL_WEB_ENGAGEMENT_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_PAGE_VISIT_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_PAGE_VISIT
            - TOTAL_WEB_VIEW_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_PAGE_VISIT_VALUE_IN_DOLLAR
            - WEB_SIGNUP_COST_PER_ACTION
            - WEB_SIGNUP_ROAS
            - TOTAL_WEB_SIGNUP
            - TOTAL_WEB_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_SIGNUP
            - TOTAL_WEB_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_SIGNUP
            - TOTAL_WEB_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_SIGNUP
            - TOTAL_WEB_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_SIGNUP_VALUE_IN_DOLLAR
            - INAPP_SIGNUP_COST_PER_ACTION
            - INAPP_SIGNUP_ROAS
            - TOTAL_INAPP_SIGNUP
            - TOTAL_INAPP_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_SIGNUP
            - TOTAL_INAPP_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_SIGNUP
            - TOTAL_INAPP_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_SIGNUP
            - TOTAL_INAPP_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_SIGNUP_VALUE_IN_DOLLAR
            - OFFLINE_SIGNUP_COST_PER_ACTION
            - OFFLINE_SIGNUP_ROAS
            - TOTAL_OFFLINE_SIGNUP
            - TOTAL_OFFLINE_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_SIGNUP
            - TOTAL_OFFLINE_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_SIGNUP
            - TOTAL_OFFLINE_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_SIGNUP_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_SIGNUP
            - TOTAL_OFFLINE_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_SIGNUP_VALUE_IN_DOLLAR
            - WEB_WATCH_VIDEO_COST_PER_ACTION
            - WEB_WATCH_VIDEO_ROAS
            - TOTAL_WEB_WATCH_VIDEO
            - TOTAL_WEB_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_WATCH_VIDEO_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_WATCH_VIDEO
            - TOTAL_WEB_CLICK_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_WATCH_VIDEO_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_WATCH_VIDEO
            - TOTAL_WEB_ENGAGEMENT_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_WATCH_VIDEO_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_WATCH_VIDEO
            - TOTAL_WEB_VIEW_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_WATCH_VIDEO_VALUE_IN_DOLLAR
            - WEB_LEAD_COST_PER_ACTION
            - WEB_LEAD_ROAS
            - TOTAL_WEB_LEAD
            - TOTAL_WEB_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_LEAD_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_LEAD
            - TOTAL_WEB_CLICK_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_LEAD_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_LEAD
            - TOTAL_WEB_ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_LEAD_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_LEAD
            - TOTAL_WEB_VIEW_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_LEAD_VALUE_IN_DOLLAR
            - OFFLINE_LEAD_COST_PER_ACTION
            - OFFLINE_LEAD_ROAS
            - TOTAL_OFFLINE_LEAD
            - TOTAL_OFFLINE_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_LEAD_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_LEAD
            - TOTAL_OFFLINE_CLICK_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_LEAD_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_LEAD
            - TOTAL_OFFLINE_ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_LEAD_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_LEAD
            - TOTAL_OFFLINE_VIEW_LEAD_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_LEAD_VALUE_IN_DOLLAR
            - WEB_SEARCH_COST_PER_ACTION
            - WEB_SEARCH_ROAS
            - TOTAL_WEB_SEARCH
            - TOTAL_WEB_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_SEARCH
            - TOTAL_WEB_CLICK_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_SEARCH
            - TOTAL_WEB_ENGAGEMENT_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_SEARCH
            - TOTAL_WEB_VIEW_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_SEARCH_VALUE_IN_DOLLAR
            - INAPP_SEARCH_COST_PER_ACTION
            - INAPP_SEARCH_ROAS
            - TOTAL_INAPP_SEARCH
            - TOTAL_INAPP_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_SEARCH
            - TOTAL_INAPP_CLICK_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_SEARCH
            - TOTAL_INAPP_ENGAGEMENT_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_SEARCH_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_SEARCH
            - TOTAL_INAPP_VIEW_SEARCH_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_SEARCH_VALUE_IN_DOLLAR
            - WEB_VIEW_CATEGORY_COST_PER_ACTION
            - WEB_VIEW_CATEGORY_ROAS
            - TOTAL_WEB_VIEW_CATEGORY
            - TOTAL_WEB_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_CATEGORY_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_VIEW_CATEGORY
            - TOTAL_WEB_CLICK_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_VIEW_CATEGORY_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_VIEW_CATEGORY
            - TOTAL_WEB_ENGAGEMENT_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_VIEW_CATEGORY_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_VIEW_CATEGORY
            - TOTAL_WEB_VIEW_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_VIEW_CATEGORY_VALUE_IN_DOLLAR
            - WEB_CUSTOM_COST_PER_ACTION
            - WEB_CUSTOM_ROAS
            - TOTAL_WEB_CUSTOM
            - TOTAL_WEB_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_CUSTOM
            - TOTAL_WEB_CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_CUSTOM
            - TOTAL_WEB_ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_CUSTOM
            - TOTAL_WEB_VIEW_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_CUSTOM_VALUE_IN_DOLLAR
            - OFFLINE_CUSTOM_COST_PER_ACTION
            - OFFLINE_CUSTOM_ROAS
            - TOTAL_OFFLINE_CUSTOM
            - TOTAL_OFFLINE_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_CUSTOM
            - TOTAL_OFFLINE_CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_CUSTOM
            - TOTAL_OFFLINE_ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_CUSTOM_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_CUSTOM
            - TOTAL_OFFLINE_VIEW_CUSTOM_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_CUSTOM_VALUE_IN_DOLLAR
            - WEB_UNKNOWN_COST_PER_ACTION
            - WEB_UNKNOWN_ROAS
            - TOTAL_WEB_UNKNOWN
            - TOTAL_WEB_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_UNKNOWN
            - TOTAL_WEB_CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_UNKNOWN
            - TOTAL_WEB_ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_UNKNOWN
            - TOTAL_WEB_VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_UNKNOWN_VALUE_IN_DOLLAR
            - INAPP_UNKNOWN_COST_PER_ACTION
            - INAPP_UNKNOWN_ROAS
            - TOTAL_INAPP_UNKNOWN
            - TOTAL_INAPP_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_UNKNOWN
            - TOTAL_INAPP_CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_UNKNOWN
            - TOTAL_INAPP_ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_UNKNOWN
            - TOTAL_INAPP_VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_UNKNOWN_VALUE_IN_DOLLAR
            - OFFLINE_UNKNOWN_COST_PER_ACTION
            - OFFLINE_UNKNOWN_ROAS
            - TOTAL_OFFLINE_UNKNOWN
            - TOTAL_OFFLINE_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_UNKNOWN
            - TOTAL_OFFLINE_CLICK_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_UNKNOWN
            - TOTAL_OFFLINE_ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_UNKNOWN_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_UNKNOWN
            - TOTAL_OFFLINE_VIEW_UNKNOWN_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_UNKNOWN_VALUE_IN_DOLLAR
            - INAPP_APP_INSTALL_COST_PER_ACTION
            - INAPP_APP_INSTALL_ROAS
            - TOTAL_INAPP_APP_INSTALL
            - TOTAL_INAPP_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_APP_INSTALL_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_APP_INSTALL
            - TOTAL_INAPP_CLICK_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_APP_INSTALL_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_APP_INSTALL
            - TOTAL_INAPP_ENGAGEMENT_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_APP_INSTALL_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_APP_INSTALL
            - TOTAL_INAPP_VIEW_APP_INSTALL_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_APP_INSTALL_VALUE_IN_DOLLAR
            - WEB_ADD_PAYMENT_INFO_COST_PER_ACTION
            - WEB_ADD_PAYMENT_INFO_ROAS
            - TOTAL_WEB_ADD_PAYMENT_INFO
            - TOTAL_WEB_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_ADD_PAYMENT_INFO
            - TOTAL_WEB_CLICK_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_ADD_PAYMENT_INFO
            - TOTAL_WEB_ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_ADD_PAYMENT_INFO
            - TOTAL_WEB_VIEW_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - INAPP_ADD_PAYMENT_INFO_COST_PER_ACTION
            - INAPP_ADD_PAYMENT_INFO_ROAS
            - TOTAL_INAPP_ADD_PAYMENT_INFO
            - TOTAL_INAPP_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_ADD_PAYMENT_INFO
            - TOTAL_INAPP_CLICK_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_ADD_PAYMENT_INFO
            - TOTAL_INAPP_ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_ADD_PAYMENT_INFO
            - TOTAL_INAPP_VIEW_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - OFFLINE_ADD_PAYMENT_INFO_COST_PER_ACTION
            - OFFLINE_ADD_PAYMENT_INFO_ROAS
            - TOTAL_OFFLINE_ADD_PAYMENT_INFO
            - TOTAL_OFFLINE_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_ADD_PAYMENT_INFO
            - TOTAL_OFFLINE_CLICK_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_ADD_PAYMENT_INFO
            - TOTAL_OFFLINE_ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_ADD_PAYMENT_INFO
            - TOTAL_OFFLINE_VIEW_ADD_PAYMENT_INFO_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_ADD_PAYMENT_INFO_VALUE_IN_DOLLAR
            - WEB_ADD_TO_WISHLIST_COST_PER_ACTION
            - WEB_ADD_TO_WISHLIST_ROAS
            - TOTAL_WEB_ADD_TO_WISHLIST
            - TOTAL_WEB_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_ADD_TO_WISHLIST
            - TOTAL_WEB_CLICK_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_ADD_TO_WISHLIST
            - TOTAL_WEB_ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_ADD_TO_WISHLIST
            - TOTAL_WEB_VIEW_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - INAPP_ADD_TO_WISHLIST_COST_PER_ACTION
            - INAPP_ADD_TO_WISHLIST_ROAS
            - TOTAL_INAPP_ADD_TO_WISHLIST
            - TOTAL_INAPP_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_ADD_TO_WISHLIST
            - TOTAL_INAPP_CLICK_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_ADD_TO_WISHLIST
            - TOTAL_INAPP_ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_ADD_TO_WISHLIST
            - TOTAL_INAPP_VIEW_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - OFFLINE_ADD_TO_WISHLIST_COST_PER_ACTION
            - OFFLINE_ADD_TO_WISHLIST_ROAS
            - TOTAL_OFFLINE_ADD_TO_WISHLIST
            - TOTAL_OFFLINE_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_ADD_TO_WISHLIST
            - TOTAL_OFFLINE_CLICK_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_ADD_TO_WISHLIST
            - TOTAL_OFFLINE_ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_ADD_TO_WISHLIST
            - TOTAL_OFFLINE_VIEW_ADD_TO_WISHLIST_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_ADD_TO_WISHLIST_VALUE_IN_DOLLAR
            - WEB_INITIATE_CHECKOUT_COST_PER_ACTION
            - WEB_INITIATE_CHECKOUT_ROAS
            - TOTAL_WEB_INITIATE_CHECKOUT
            - TOTAL_WEB_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_INITIATE_CHECKOUT
            - TOTAL_WEB_CLICK_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_INITIATE_CHECKOUT
            - TOTAL_WEB_ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_INITIATE_CHECKOUT
            - TOTAL_WEB_VIEW_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - INAPP_INITIATE_CHECKOUT_COST_PER_ACTION
            - INAPP_INITIATE_CHECKOUT_ROAS
            - TOTAL_INAPP_INITIATE_CHECKOUT
            - TOTAL_INAPP_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_INITIATE_CHECKOUT
            - TOTAL_INAPP_CLICK_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_INITIATE_CHECKOUT
            - TOTAL_INAPP_ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_INITIATE_CHECKOUT
            - TOTAL_INAPP_VIEW_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - OFFLINE_INITIATE_CHECKOUT_COST_PER_ACTION
            - OFFLINE_INITIATE_CHECKOUT_ROAS
            - TOTAL_OFFLINE_INITIATE_CHECKOUT
            - TOTAL_OFFLINE_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_INITIATE_CHECKOUT
            - TOTAL_OFFLINE_CLICK_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_INITIATE_CHECKOUT
            - TOTAL_OFFLINE_ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_INITIATE_CHECKOUT
            - TOTAL_OFFLINE_VIEW_INITIATE_CHECKOUT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_INITIATE_CHECKOUT_VALUE_IN_DOLLAR
            - WEB_SUBSCRIBE_COST_PER_ACTION
            - WEB_SUBSCRIBE_ROAS
            - TOTAL_WEB_SUBSCRIBE
            - TOTAL_WEB_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_SUBSCRIBE
            - TOTAL_WEB_CLICK_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_SUBSCRIBE
            - TOTAL_WEB_ENGAGEMENT_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_SUBSCRIBE
            - TOTAL_WEB_VIEW_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_SUBSCRIBE_VALUE_IN_DOLLAR
            - INAPP_SUBSCRIBE_COST_PER_ACTION
            - INAPP_SUBSCRIBE_ROAS
            - TOTAL_INAPP_SUBSCRIBE
            - TOTAL_INAPP_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_SUBSCRIBE
            - TOTAL_INAPP_CLICK_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_SUBSCRIBE
            - TOTAL_INAPP_ENGAGEMENT_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_SUBSCRIBE
            - TOTAL_INAPP_VIEW_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_SUBSCRIBE_VALUE_IN_DOLLAR
            - OFFLINE_SUBSCRIBE_COST_PER_ACTION
            - OFFLINE_SUBSCRIBE_ROAS
            - TOTAL_OFFLINE_SUBSCRIBE
            - TOTAL_OFFLINE_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_SUBSCRIBE
            - TOTAL_OFFLINE_CLICK_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_SUBSCRIBE
            - TOTAL_OFFLINE_ENGAGEMENT_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_SUBSCRIBE_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_SUBSCRIBE
            - TOTAL_OFFLINE_VIEW_SUBSCRIBE_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_SUBSCRIBE_VALUE_IN_DOLLAR
            - WEB_VIEW_CONTENT_COST_PER_ACTION
            - WEB_VIEW_CONTENT_ROAS
            - TOTAL_WEB_VIEW_CONTENT
            - TOTAL_WEB_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_WEB_CLICK_VIEW_CONTENT
            - TOTAL_WEB_CLICK_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_CLICK_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_VIEW_CONTENT
            - TOTAL_WEB_ENGAGEMENT_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_ENGAGEMENT_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_WEB_VIEW_VIEW_CONTENT
            - TOTAL_WEB_VIEW_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_WEB_VIEW_VIEW_CONTENT_VALUE_IN_DOLLAR
            - INAPP_VIEW_CONTENT_COST_PER_ACTION
            - INAPP_VIEW_CONTENT_ROAS
            - TOTAL_INAPP_VIEW_CONTENT
            - TOTAL_INAPP_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_INAPP_CLICK_VIEW_CONTENT
            - TOTAL_INAPP_CLICK_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_CLICK_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_VIEW_CONTENT
            - TOTAL_INAPP_ENGAGEMENT_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_ENGAGEMENT_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_INAPP_VIEW_VIEW_CONTENT
            - TOTAL_INAPP_VIEW_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_INAPP_VIEW_VIEW_CONTENT_VALUE_IN_DOLLAR
            - OFFLINE_VIEW_CONTENT_COST_PER_ACTION
            - OFFLINE_VIEW_CONTENT_ROAS
            - TOTAL_OFFLINE_VIEW_CONTENT
            - TOTAL_OFFLINE_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_CLICK_VIEW_CONTENT
            - TOTAL_OFFLINE_CLICK_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_CLICK_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_VIEW_CONTENT
            - TOTAL_OFFLINE_ENGAGEMENT_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_ENGAGEMENT_VIEW_CONTENT_VALUE_IN_DOLLAR
            - TOTAL_OFFLINE_VIEW_VIEW_CONTENT
            - TOTAL_OFFLINE_VIEW_VIEW_CONTENT_VALUE_IN_MICRO_DOLLAR
            - TOTAL_OFFLINE_VIEW_VIEW_CONTENT_VALUE_IN_DOLLAR
            - IDEA_PIN_PAGE_FORWARD_1
            - IDEA_PIN_PAGE_FORWARD_2
            - IDEA_PIN_PAGE_BACKWARD_1
            - IDEA_PIN_PAGE_BACKWARD_2
            - TOTAL_IDEA_PIN_PAGE_FORWARD
            - TOTAL_IDEA_PIN_PAGE_BACKWARD
            - IDEA_PIN_PRODUCT_TAG_VISIT_1
            - IDEA_PIN_PRODUCT_TAG_VISIT_2
            - TOTAL_IDEA_PIN_PRODUCT_TAG_VISIT
            - CPM_IN_US_DOLLAR
            - ECPC_IN_US_DOLLAR
            - LEADS
            - COST_PER_LEAD
            - QUIZ_STARTED
            - QUIZ_COMPLETED
            - QUIZ_PIN_RESULT_OPEN
            - QUIZ_COMPLETION_RATE
            - SHOWCASE_PIN_CLICKTHROUGH
            - SHOWCASE_SUBPAGE_CLICKTHROUGH
            - SHOWCASE_SUBPIN_CLICKTHROUGH
            - SHOWCASE_SUBPAGE_IMPRESSION
            - SHOWCASE_SUBPIN_IMPRESSION
            - SHOWCASE_SUBPAGE_SWIPE_LEFT
            - SHOWCASE_SUBPAGE_SWIPE_RIGHT
            - SHOWCASE_SUBPIN_SWIPE_LEFT
            - SHOWCASE_SUBPIN_SWIPE_RIGHT
            - SHOWCASE_SUBPAGE_REPIN
            - SHOWCASE_SUBPIN_REPIN
            - SHOWCASE_SUBPAGE_CLOSEUP
            - SHOWCASE_CARD_THUMBNAIL_SWIPE_FORWARD
            - SHOWCASE_CARD_THUMBNAIL_SWIPE_BACKWARD
            - _SHOWCASE_SUBPAGE_CLOSEUP_INTERNAL
            - SHOWCASE_CARD_LANDING
            - SHOWCASE_AVERAGE_SUBPAGE_CLOSEUP_PER_SESSION
            - TOTAL_CHECKOUT_CONVERSION_RATE
            - TOTAL_VIEW_CATEGORY_CONVERSION_RATE
            - TOTAL_ADD_TO_CART_CONVERSION_RATE
            - TOTAL_SIGNUP_CONVERSION_RATE
            - TOTAL_PAGE_VISIT_CONVERSION_RATE
            - TOTAL_LEAD_CONVERSION_RATE
            - TOTAL_SEARCH_CONVERSION_RATE
            - TOTAL_WATCH_VIDEO_CONVERSION_RATE
            - TOTAL_UNKNOWN_CONVERSION_RATE
            - TOTAL_CUSTOM_CONVERSION_RATE
            - TOTAL_ADD_PAYMENT_INFO_CONVERSION_RATE
            - TOTAL_ADD_TO_WISHLIST_CONVERSION_RATE
            - TOTAL_INITIATE_CHECKOUT_CONVERSION_RATE
            - TOTAL_SUBSCRIBE_CONVERSION_RATE
            - TOTAL_VIEW_CONTENT_CONVERSION_RATE
            - STANDARD_AD_FEED_ITEM_ID
            - IS_STANDARD_FEED_AD
            - TARGETING_GENDER
            - TARGETING_CREATIVE_TYPE
            - TARGETING_COUNTRY
            - TARGETING_LOCATION
            - TARGETING_APPTYPE
            - TARGETING_LOCATION_CODE
            - TARGETING_MEDIA_TYPE
            - TARGETING_AGE_BUCKET
            - TARGETING_AUDIENCE_MULTIPLIER
            - TOTAL_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_CONVERSION_PRODUCT_VALUE
            - TOTAL_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_CHECKOUT_CONVERSION_PRODUCT_VALUE
            - TOTAL_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_CHECKOUT_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_CHECKOUT_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_CHECKOUT_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_ADD_TO_CART_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_ADD_TO_CART_CONVERSION_PRODUCT_VALUE
            - TOTAL_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_ADD_TO_CART_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_ADD_TO_CART_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_ADD_TO_CART_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_ADD_TO_CART_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_ADD_TO_CART_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_PAGE_VISIT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_PAGE_VISIT_CONVERSION_PRODUCT_VALUE
            - TOTAL_PAGE_VISIT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_PAGE_VISIT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_PAGE_VISIT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_PAGE_VISIT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_PAGE_VISIT_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_PAGE_VISIT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_PAGE_VISIT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_PAGE_VISIT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_SIGNUP_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_SIGNUP_CONVERSION_PRODUCT_VALUE
            - TOTAL_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_SIGNUP_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_SIGNUP_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_SIGNUP_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_SIGNUP_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_SIGNUP_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_SIGNUP_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_SIGNUP_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WATCH_VIDEO_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE
            - TOTAL_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_WATCH_VIDEO_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_WATCH_VIDEO_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_LEAD_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_LEAD_CONVERSION_PRODUCT_VALUE
            - TOTAL_LEAD_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_LEAD_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_LEAD_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_LEAD_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_LEAD_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_LEAD_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_LEAD_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_LEAD_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_LEAD_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_LEAD_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_LEAD_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_LEAD_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_LEAD_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_SEARCH_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_SEARCH_CONVERSION_PRODUCT_VALUE
            - TOTAL_SEARCH_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_SEARCH_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_SEARCH_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_SEARCH_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_SEARCH_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_SEARCH_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_SEARCH_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_SEARCH_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_SEARCH_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_SEARCH_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_SEARCH_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_SEARCH_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_SEARCH_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_VIEW_CATEGORY_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE
            - TOTAL_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_VIEW_CATEGORY_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_VIEW_CATEGORY_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_CUSTOM_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_CUSTOM_CONVERSION_PRODUCT_VALUE
            - TOTAL_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_CUSTOM_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_CUSTOM_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_CUSTOM_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_CUSTOM_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_CUSTOM_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_UNKNOWN_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_UNKNOWN_CONVERSION_PRODUCT_VALUE
            - TOTAL_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_UNKNOWN_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_UNKNOWN_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_UNKNOWN_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_UNKNOWN_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_UNKNOWN_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_UNKNOWN_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_UNKNOWN_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE
            - TOTAL_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_ADD_TO_WISHLIST_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE
            - TOTAL_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_ADD_TO_WISHLIST_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_ADD_TO_WISHLIST_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_ADD_TO_WISHLIST_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_ADD_TO_WISHLIST_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INITIATE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE
            - TOTAL_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_INITIATE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_INITIATE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_INITIATE_CHECKOUT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_INITIATE_CHECKOUT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_SUBSCRIBE_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_SUBSCRIBE_CONVERSION_PRODUCT_VALUE
            - TOTAL_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_SUBSCRIBE_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_SUBSCRIBE_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_SUBSCRIBE_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_SUBSCRIBE_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_SUBSCRIBE_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_SUBSCRIBE_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_OFFLINE_SUBSCRIBE_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_VIEW_CONTENT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE
            - TOTAL_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_WEB_VIEW_CONTENT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_WEB_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE
            - TOTAL_WEB_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_WEB_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_WEB_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_INAPP_VIEW_CONTENT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_INAPP_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE
            - TOTAL_INAPP_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_INAPP_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_INAPP_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_VIEW_CONTENT_CONVERSION_PRODUCT_QUANTITY
            - TOTAL_OFFLINE_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE
            - TOTAL_OFFLINE_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_MICRO_UNITS
            - TOTAL_OFFLINE_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_MICRO_USD
            - TOTAL_OFFLINE_VIEW_CONTENT_CONVERSION_PRODUCT_VALUE_IN_USD
            - TOTAL_CHECKOUT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_CHECKOUT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_CHECKOUT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_CHECKOUT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_ADD_TO_CART_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_ADD_TO_CART_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_ADD_TO_CART_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_PAGE_VISIT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_PAGE_VISIT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_SIGNUP_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_SIGNUP_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_SIGNUP_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_SIGNUP_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WATCH_VIDEO_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_WATCH_VIDEO_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_LEAD_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_LEAD_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_LEAD_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_SEARCH_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_SEARCH_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_SEARCH_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_VIEW_CATEGORY_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_VIEW_CATEGORY_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_CUSTOM_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_CUSTOM_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_CUSTOM_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_UNKNOWN_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_UNKNOWN_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_UNKNOWN_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_UNKNOWN_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_ADD_PAYMENT_INFO_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_ADD_TO_WISHLIST_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_ADD_TO_WISHLIST_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_ADD_TO_WISHLIST_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_ADD_TO_WISHLIST_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INITIATE_CHECKOUT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_INITIATE_CHECKOUT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_INITIATE_CHECKOUT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_INITIATE_CHECKOUT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_SUBSCRIBE_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_SUBSCRIBE_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_SUBSCRIBE_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_SUBSCRIBE_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_VIEW_CONTENT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_WEB_VIEW_CONTENT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_INAPP_VIEW_CONTENT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - TOTAL_OFFLINE_VIEW_CONTENT_CONVERSION_PRODUCT_COUNT_UNIQUE
            - GEN_AI_IMAGE_SIGNATURE
            - GEN_AI_IMAGE_URL
            - ORIGINAL_IMAGE_SIGNATURE
            - ORIGINAL_IMAGE_URL
            - GEN_AI_GENERATION_DATE
            - IS_REGENERATING
            - GEN_AI_IMAGE_COUNT
            - ADVERTISER_TIME_ZONE
          type: array
        granularity:
          $ref: '#/components/schemas/Granularity'
        view_window_days:
          description: The length of the sliding window over which view conversions
            will be attributed
          example: 7
          type: number
        click_window_days:
          description: The length of the sliding window over which click conversions
            will be attributed
          example: 7
          type: number
        engagement_window_days:
          description: The length of the sliding window over which engagement conversions
            will be attributed
          example: 7
          type: number
        conversion_report_time_type:
          description: Conversion report time type
          enum:
          - TIME_OF_AD_ACTION
          - TIME_OF_CONVERSION
          example: TIME_OF_AD_ACTION
          type: string
        filters_json:
          description: 'A JSON representation of any filters to be applied before
            returning report data. Each filter object should contain all of the following
            fields:<br> "field": The column name<br> "operator": The operator. Allowed
            operators: ["=", "!=", "in", "not_in", "~", ">", "<", "contains_substring"]<br>
            "value": A single value or a list of values'
          example: '[{"field": "SPEND_IN_DOLLAR", "operator": "=", "value": 100}]'
          nullable: true
          type: string
        is_owned_by_user:
          description: A boolean value that indicates if the user owns the template
          example: true
          type: boolean
        is_scheduled:
          description: A boolean value that indicates if this template has been used
            to create a scheduled report
          example: true
          type: boolean
        creation_source:
          description: The surface used to create this template
          enum:
          - ADS_API
          - ADS_MANAGER_REPORTING_PAGE
          - ADS_MANAGER_REPORT_BUILDER
          example: ADS_MANAGER_REPORT_BUILDER
          type: string
        is_deleted:
          description: A boolean that indicates if the template has been deleted
          example: false
          nullable: true
          type: boolean
        updated_time:
          description: Time of last update in seconds since Unix epoch
          example: 1432744744
          type: number
        custom_column_ids:
          description: A list of custom column IDs
          example:
          - '1597252063'
          items:
            $ref: '#/components/schemas/CustomColumnId'
          nullable: true
          type: array
        type:
          allOf:
          - description: Reporting template type
            enum:
            - UNSPECIFIED
            - BULK
            - OVERVIEW
            - TABLE
            example: BULK
            type: string
          description: Type of the template
          example: BULK
          type: string
        ingestion_sources:
          description: The filter on the conversion ingestion source method for conversion
            metrics
          items:
            description: The source of conversion events ingestion
            enum:
            - TAG
            - MMP
            - FILE_UPLOAD
            - CONVERSIONS_API
            - NATIVE
            example: CONVERSIONS_API
            type: string
          nullable: true
          type: array
    TermsOfService:
      example:
        has_accepted: true
        html: example test
        id: '2650449554526'
        ad_account_id: '549755885175'
      properties:
        id:
          description: The ID of the terms of service
          example: '2650449554526'
          title: id
          type: string
        html:
          description: The terms of service content
          example: example test
          nullable: true
          title: html
          type: string
        has_accepted:
          description: Whether the ad account has accepted terms of service.
          example: true
          title: hasAccepted
          type: boolean
        ad_account_id:
          description: The ID of the ad account.
          example: '549755885175'
          title: adAccountId
          type: string
      title: TermsOfService
      type: object
    TermsSuggestedResponse:
      items:
        type: string
      type: array
    TopPinsAnalyticsResponse:
      type: object
      properties:
        date_availability:
          type: object
          properties:
            latest_available_timestamp:
              type: number
              example: 1649116799000
            is_realtime:
              type: boolean
              example: false
        pins:
          type: array
          items:
            description: Array with metrics, status, and pin id for the requested
              metric
            type: object
            properties:
              metrics:
                $ref: '#/components/schemas/Metrics'
              data_status:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/DataStatus'
              pin_id:
                description: The pin id
                type: string
                example: '642396334344813594'
        sort_by:
          type: string
          enum:
          - ENGAGEMENT
          - SAVE
          - IMPRESSION
          - OUTBOUND_CLICK
          - PIN_CLICK
          example: IMPRESSION
    TopVideoPinsAnalyticsResponse:
      type: object
      properties:
        date_availability:
          type: object
          properties:
            latest_available_timestamp:
              type: number
              example: 1649116799000
            is_realtime:
              type: boolean
              example: false
        pins:
          type: array
          items:
            description: Array with metrics, status, and pin id for the requested
              metric
            type: object
            properties:
              metrics:
                description: The metric name and daily value for each requested metric
                type: object
                additionalProperties:
                  type: number
                example:
                  IMPRESSION: 7
                  QUARTILE_95_PERCENT_VIEW: 2
                  SAVE: 1
                  VIDEO_10S_VIEW: 5
                  VIDEO_AVG_WATCH_TIME: 86989
                  VIDEO_MRC_VIEW: 2
                  VIDEO_START: 2
                  VIDEO_V50_WATCH_TIME: 173979
                  OUTBOUND_CLICK: 2
              data_status:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/DataStatus'
              pin_id:
                description: The pin id
                type: string
                example: '642396334344813594'
        sort_by:
          type: string
          enum:
          - SAVE
          - IMPRESSION
          - OUTBOUND_CLICK
          - VIDEO_MRC_VIEW
          - VIDEO_AVG_WATCH_TIME
          - VIDEO_V50_WATCH_TIME
          - QUARTILE_95_PERCENT_VIEW
          - VIDEO_10S_VIEW
          - VIDEO_START
          example: IMPRESSION
    TrackingUrls:
      description: Third-party tracking URLs. Up to three tracking URLs - with a max
        length of 2,000 - are supported for each event type. Tracking URLs set at
        the ad group or ad level can override those set at the campaign level. For
        more information, see <a href="https://help.pinterest.com/en/business/article/third-party-and-dynamic-tracking"
        target="_blank">Third-party and dynamic tracking</a>.
      example:
        impression:
        - URL1
        - URL2
        click:
        - URL1
        - URL2
        engagement:
        - URL1
        - URL2
        buyable_button:
        - URL1
        - URL2
        audience_verification:
        - URL1
        - URL2
      type: object
      nullable: true
      properties:
        impression:
          type: array
          items:
            type: string
        click:
          type: array
          items:
            type: string
        engagement:
          type: array
          items:
            type: string
        buyable_button:
          type: array
          items:
            type: string
        audience_verification:
          type: array
          items:
            type: string
    TrendType:
      title: TrendType
      type: string
      example: monthly
      enum:
      - growing
      - monthly
      - yearly
      - seasonal
    TrendingKeywordsResponse:
      type: object
      properties:
        trends:
          description: |-
            The top trending keywords for the specified trend type in the requested region.<br />
            Results are ordered, with the first element in the array representing the #1 top trend.
          type: array
          items:
            title: TrendingKeyword
            type: object
            properties:
              keyword:
                description: The keyword that is trending.
                example: couples halloween costumes
                type: string
                minLength: 1
              pct_growth_wow:
                description: |-
                  The week-over-week percent change in search volume for this keyword.<br />
                  For example, a value of "50" would represent a 50% increase in searches in the last seven days compared to the week prior.<br />
                  **Note**: growth rates are rounded, with a maximum of +/- 10000% change.  A value of 10001 indicates that this keyword experienced > 10000% week-over-week growth.
                example: 50
                type: integer
              pct_growth_mom:
                description: |-
                  The month-over-month percent change in search volume for this keyword.<br />
                  For example, a value of "400" would represent a 400% increase in searches in the last 30 days compared to the month prior.<br />
                  **Note**: growth rates are rounded, with a maximum of +/- 10000% change.  A value of 10001 indicates that this keyword experienced > 10000% month-over-month growth.
                example: 400
                type: integer
              pct_growth_yoy:
                description: |-
                  The year-over-year percent change in search volume for this keyword.<br />
                  For example, a value of "-5" would represent a 5% decrease in searches in the last 365 days compared to the month prior.<br />
                  **Note**: growth rates are rounded, with a maximum of +/- 10000% change.  A value of 10001 indicates that this keyword experienced > 10000% year-over-year growth.
                example: -5
                type: integer
              has_prediction:
                description: |-
                  Indicates whether the keyword has a prediction available for the next 90 days.<br />
                  This field is only applicable when `include_prediction` query parameter is set to `true`. <br />
                  By default, the value is `false` and no prediction data is included in the response.
                type: boolean
                example: false
              demographics:
                type: object
                nullable: true
                description: |-
                  A mapping of demographic dimensions (e.g. "gender", "age") to their category distributions. <br />
                  For each dimension: <br />
                    - Key: The category (e.g., "female", "18-24"). <br />
                    - Value: The proportion of search volume (e.g., 0.12 for 12%). <br />
                      Values less than 0.05 are set to 0.04 for privacy. <br />
                      The sum for all categories in a dimension will approximately equal 1. <br />
                      Only applicable when `include_demographics` query parameter is set to `true`.
                properties:
                  gender_distribution:
                    type: object
                    description: |-
                      This represents a mapping from gender to distribution of search volume for a keyword.
                      The sum of all values in this object should approximately be 1.
                    example:
                      female: 0.85
                      male: 0.09
                      unspecified: 0.06
                    properties:
                      gender_distribution:
                        type: string
                        enum:
                        - male
                        - female
                        - unspecified
                    additionalProperties:
                      type: number
                      format: double
                    nullable: true
                  age_distribution:
                    type: object
                    description: |-
                      This represents a mapping from age bucket to distribution of search volume for a keyword.
                      The sum of all values in this object should approximately be 1.
                    example:
                      18-24: 0.36
                      25-34: 0.38
                      35-44: 0.16
                      45-49: 0.04
                      50-54: 0.04
                      55-64: 0.04
                      65+: 0.04
                    properties:
                      age_distribution:
                        type: string
                        enum:
                        - 18-24
                        - 25-34
                        - 35-44
                        - 45-49
                        - 50-54
                        - 55-64
                        - 65+
                    additionalProperties:
                      type: number
                      format: double
                    nullable: true
              time_series:
                description: |-
                  A sequence of weekly observations of the relative search volume for this keyword over the past year.<br />
                  These values are normalized to a [0-100] range, and can be used to visualize the history of user interest in this keyword.
                  By default, normalization is applied independently to the time series of each keyword, but the `normalize_against_group` query parameter can be used in cases where you wish to compare relative volume between keywords.<br />
                  **Note**: The date of each observation is in ISO-8601 format and represents the *end* of the week.  For example, a value of `2023-10-31` would include searches that happened between `2023-10-25` and `2023-10-31`.
                example:
                  '2023-10-10': 31
                  '2023-10-17': 54
                  '2023-10-24': 77
                  '2023-10-31': 100
                type: object
                title: TimeSeries
                properties:
                  date:
                    type: string
                    format: date
                additionalProperties:
                  type: integer
    TrendsSupportedRegion:
      title: Region
      type: string
      example: GB+IE
      enum:
      - US
      - CA
      - DE
      - FR
      - ES
      - IT
      - DE+AT+CH
      - GB+IE
      - IT+ES+PT+GR+MT
      - PL+RO+HU+SK+CZ
      - SE+DK+FI+NO
      - NL+BE+LU
      - AR
      - BR
      - CO
      - MX
      - MX+AR+CO+CL
      - AU+NZ
    UpdatableItemAttributes:
      type: object
      properties:
        ad_link:
          description: "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\u2014do not send tracking parameters only. At\
            \ this time we do not support impression tracking. Must begin with http://\
            \ or https://."
          example: https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest
          type: string
          nullable: true
        adult:
          description: "Set this attribute to TRUE if you're submitting items that\
            \ are considered \u201Cadult\u201D. These will not be shown on Pinterest."
          example: true
          type: boolean
          nullable: true
        age_group:
          description: "The age group to apply a demographic range to the product.\
            \ Must be one of the following values (upper or lowercased): \u2018newborn\u2019\
            \ , \u2018infant\u2019, \u2018toddler\u2019, \u2018kids\u2019, or \u2018\
            adult\u2019."
          example: newborn
          type: string
          nullable: true
        availability:
          description: "The availability of the product. Must be one of the following\
            \ values (upper or lowercased): \u2018in stock\u2019, \u2018out of stock\u2019\
            \ , \u2018preorder\u2019."
          example: in stock
          type: string
        average_review_rating:
          description: Average reviews for the item. Can be a number from 1-5.
          example: 5
          type: number
          nullable: true
        brand:
          description: The brand of the product.
          example: "Josie\u2019s Denim"
          type: string
          nullable: true
        checkout_enabled:
          description: This attribute is not supported anymore.
          example: false
          type: boolean
          nullable: true
          deprecated: true
        color:
          description: The primary color of the product.
          example: blue
          type: string
          nullable: true
        condition:
          description: "The condition of the product. Must be one of the following\
            \ values (upper or lowercased): \u2018new\u2019, \u2018used\u2019, or\
            \ \u2018refurbished\u2019."
          example: new
          type: string
          nullable: true
        custom_label_0:
          description: |-
            <p><= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs</p>
            <p>Custom grouping of products.</p>
          example: Best sellers
          type: string
          maxLength: 511
          nullable: true
        custom_label_1:
          description: |-
            <p><= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs</p>
            <p>Custom grouping of products.</p>
          example: Summer promotion
          type: string
          maxLength: 511
          nullable: true
        custom_label_2:
          description: |-
            <p><= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs</p>
            <p>Custom grouping of products.</p>
          example: Winter sales
          type: string
          maxLength: 511
          nullable: true
        custom_label_3:
          description: |-
            <p><= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs</p>
            <p>Custom grouping of products.</p>
          example: Woman dress
          type: string
          maxLength: 511
          nullable: true
        custom_label_4:
          description: |-
            <p><= 511 characters for retail and creative asset catalogs, <= 127 characters for hotel catalogs</p>
            <p>Custom grouping of products.</p>
          example: Man hat
          type: string
          maxLength: 511
          nullable: true
        custom_number_0:
          description: an attribute for any integer information ranging from 0 to
            4,294,967,295, which can be used to group items.
          example: 10
          type: integer
          nullable: true
        custom_number_1:
          description: an attribute for any integer information ranging from 0 to
            4,294,967,295, which can be used to group items.
          example: 0
          type: integer
          nullable: true
        custom_number_2:
          description: an attribute for any integer information ranging from 0 to
            4,294,967,295, which can be used to group items.
          example: 1520000000
          type: integer
          nullable: true
        custom_number_3:
          description: an attribute for any integer information ranging from 0 to
            4,294,967,295, which can be used to group items.
          example: 4294967295
          type: integer
          nullable: true
        custom_number_4:
          description: an attribute for any integer information ranging from 0 to
            4,294,967,295, which can be used to group items.
          example: 50
          type: integer
          nullable: true
        description:
          description: |-
            <p><= 10000 characters</p>
            <p>The description of the product.</p>
          example: Casual fit denim shirt made with the finest quality Japanese denim.
          type: string
        free_shipping_label:
          description: The item is free to ship.
          example: true
          type: boolean
          nullable: true
        free_shipping_limit:
          description: The minimum order purchase necessary for the customer to get
            free shipping. Only relevant if free shipping is offered.
          example: 35 USD
          type: string
          nullable: true
        gender:
          description: "The gender associated with the product. Must be one of the\
            \ following values (upper or lowercased): \u2018male\u2019, \u2018female\u2019\
            \ , or \u2018unisex\u2019."
          example: unisex
          type: string
          nullable: true
        google_product_category:
          description: 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.
          example: Apparel & Accessories > Clothing > Shirts & Tops
          type: string
          nullable: true
        gtin:
          description: The unique universal product identifier.
          example: '3234567890126'
          oneOf:
          - type: string
            nullable: true
          - type: integer
            deprecated: true
            description: 'DEPRECATED: Integer format will be removed in future versions.
              Please use string format to preserve leading zeros and maintain GTIN
              integrity.'
          nullable: true
        id:
          description: |-
            <p><= 127 characters</p>
            <p>The user-created unique ID that represents the product. Only
            Unicode characters are accepted.</p>
          example: DS0294-L
          type: string
          deprecated: true
        item_group_id:
          description: |-
            <p><= 127 characters</p>
            <p>The parent ID of the product.</p>
          example: DS0294
          type: string
          nullable: true
        last_updated_time:
          description: The millisecond timestamp when the item was lastly modified
            by the merchant.
          example: 1641483432072
          type: integer
          format: int64
          nullable: true
        link:
          description: |-
            <p><= 511 characters</p>
            <p>The landing page for the product.</p>
          example: https://www.example.com/cat/womens-clothing/denim-shirt-0294
          type: string
        material:
          description: The material used to make the product.
          example: cotton
          type: string
          nullable: true
        min_ad_price:
          description: 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.
          example: 19.99 USD
          type: string
          nullable: true
        mobile_link:
          description: The mobile-optimized version of your landing page. Must begin
            with http:// or https://.
          example: https://m.example.com/cat/womens-clothing/denim-shirt-0294
          type: string
          nullable: true
        mpn:
          description: 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.
          example: PI12345NTEREST
          type: string
          nullable: true
        number_of_ratings:
          description: The number of ratings for the item.
          example: 10
          type: integer
          nullable: true
        number_of_reviews:
          description: The number of reviews available for the item.
          example: 10
          type: integer
          nullable: true
        pattern:
          description: The description of the pattern used for the product.
          example: plaid
          type: string
          nullable: true
        price:
          description: 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.
          example: 24.99 USD
          type: string
        product_type:
          description: "<p><= 1000 characters</p>\n<p>The categorization of your product\
            \ based on your custom product\ntaxonomy. Subcategories must be sent separated\
            \ by \u201C > \u201C. The > must be\nwrapped by spaces. We do not recognize\
            \ any other delimiters such as comma\nor pipe.</p>"
          example: "Clothing > Women\u2019s > Shirts > Denim"
          type: string
          nullable: true
        sale_price:
          description: 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". If the currency is not included, we default to
            US dollars.
          example: 14.99 USD
          type: string
          nullable: true
        shipping:
          description: 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.
          example: US:CA:Ground:0 USD
          type: string
          nullable: true
        shipping_height:
          description: The height of the package needed to ship the product. Ensure
            there is a space between the numeric string and the metric.
          example: 12 in
          type: string
          nullable: true
        shipping_weight:
          description: The weight of the product. Ensure there is a space between
            the numeric string and the metric.
          example: 3 kg
          type: string
          nullable: true
        shipping_width:
          description: The width of the package needed to ship the product. Ensure
            there is a space between the numeric string and the metric.
          example: 16 in
          type: string
          nullable: true
        size:
          description: The size of the product.
          example: M
          type: string
          nullable: true
        size_system:
          description: "Indicates the country\u2019s sizing system in which you are\
            \ submitting your product. Must be one of the following values (upper\
            \ or lowercased): \u2018US\u2019, \u2018UK\u2019, \u2018EU\u2019, \u2018\
            DE\u2019 , \u2018FR\u2019, \u2018JP\u2019, \u2018CN\u2019, \u2018IT\u2019\
            , \u2018 BR\u2019, \u2018MEX\u2019, or \u2018AU\u2019."
          example: US
          type: string
          nullable: true
        size_type:
          description: "Additional description for the size. Must be one of the following\
            \ values (upper or lowercased): \u2018regular\u2019, \u2018petite\u2019\
            \ , \u2018plus\u2019, \u2018big_and_tall\u2019, or \u2018maternity\u2019\
            ."
          example: regular
          type: string
          nullable: true
        tax:
          description: 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.
          example: US:1025433:6.00:y
          type: string
          nullable: true
        title:
          description: |-
            <p><= 500 characters</p>
            <p>The name of the product.</p>
          example: "Women\u2019s denim shirt, large"
          type: string
        variant_names:
          description: 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.
          example:
          - Color
          - Size
          type: array
          nullable: true
          items:
            type: string
        variant_values:
          description: 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.
          example:
          - Red
          - Small
          type: array
          nullable: true
          items:
            type: string
        promotion_id:
          description: A unique identifier referencing the promotion associated with
            this catalog item.
          example: promotion_1
          type: string
          nullable: true
        ad_image_0_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_1_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_2_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_3_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_4_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_5_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_6_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_7_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_8_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_9_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_10_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_11_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_12_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_13_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_14_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_15_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_16_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_17_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_18_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_19_link:
          type: string
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 2000 characters</p>
            <p>Ad image link that supplements main image for shopping campaigns.</p>
            <p>Image format:</p>
            <ul>
              <li>Pixel size at least 75 x 75</li>
            </ul>
            <p>Link guidelines:</p>
            <ul>
              <li>Include extension in file name</li>
              <li>Do not include template or placeholder images in link</li>
              <li>Make URL accessible to Pinterest user-agent</li>
              <li>Must start with http:// or https://</li>
            </ul>
          example: https://www.example.com/image/image_v2.jpg
          nullable: true
        ad_image_0_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_1_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_2_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_3_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_4_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_5_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_6_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_7_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_8_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_9_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_10_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_11_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_12_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_13_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_14_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_15_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_16_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_17_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_18_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
        ad_image_19_tag:
          description: |-
            <a href="/docs/getting-started/using-beta-and-restricted-features/" target="blank" target="blank">Restricted</a>
            <p><= 511 characters</p>
            <p>If you provide an ad_image_x_link, include the image tag with the corresponding ad_image_x_tag attribute.</p>
          example: black friday
          type: string
          nullable: true
    UserBusinessRoleBinding:
      type: object
      properties:
        assets_summary:
          type: object
          nullable: true
          allOf:
          - $ref: '#/components/schemas/BusinessMemberAssetsSummary'
        business_roles:
          description: The access level a user has on the business. This can be EMPLOYEE,
            BIZ_ADMIN, or PARTNER.
          type: array
          example:
          - BIZ_ADMIN
          items:
            $ref: '#/components/schemas/BusinessRoleResponse'
        created_by_business:
          type: object
          nullable: true
          description: Metadata for the business that created the business relationship.
          allOf:
          - $ref: '#/components/schemas/BusinessAccessUserSummary'
        created_by_user:
          type: object
          nullable: true
          description: Metadata for the user that created the business relationship.
          allOf:
          - $ref: '#/components/schemas/BusinessAccessUserSummary'
        created_time:
          type: integer
          nullable: true
          description: The time the business relationship was created. Returned in
            milliseconds.
          example: 1646767577816
        id:
          type: string
          description: Unique identifier of the business member/business partner/employer.
          example: '383791336903426391'
          pattern: ^\d+$
        is_shared_partner:
          type: boolean
          description: |-
            This field is only relevant when business_role="PARTNER".
            <br>If is_shared_partner=FALSE, the partner can access your business assets. If assets_summary
            is not empty, the assets listed are your business assets the partner has access to.
            <br>If is_shared_partner=TRUE, you can access the partner's business asset. If assets_summary
            is not empty, the assets listed are the partner's business assets you have access to.
          example: false
        user:
          type: object
          nullable: true
          description: Metadata for the business member/business partner/employer.
          allOf:
          - $ref: '#/components/schemas/BusinessAccessUserSummary'
    CreateAssetInvitesRequestItem:
      description: Object declaring an asset role update to an invite.
      type: object
      required:
      - invite_id
      - invite_type
      - asset_id_to_permissions
      properties:
        invite_id:
          description: Unique identifier of an invite.
          example: '1234567890123'
          type: string
          pattern: ^\d+$
        invite_type:
          $ref: '#/components/schemas/InviteType'
        asset_id_to_permissions:
          $ref: '#/components/schemas/AssetIdToPermissions'
    CreateAssetInvitesRequest:
      description: Request body for updating asset roles for existing invites.
      type: object
      required:
      - invites
      properties:
        invites:
          type: array
          minItems: 1
          maxItems: 50
          items:
            $ref: '#/components/schemas/CreateAssetInvitesRequestItem'
    UpdateAssetGroupBody:
      type: object
      properties:
        asset_groups_to_update:
          type: array
          description: A list of asset groups and the data that will be used to update
            them.
          items:
            type: object
            properties:
              asset_group_id:
                description: Unique identifier of the asset group to update.
                title: asset_group_id
                type: string
                example: '666791336903426391'
              name:
                description: Asset Group name
                example: Canada Ad Accounts
                title: name
                type: string
              description:
                description: Asset group description
                example: Asset groups that has ad accounts shared in Canada
                title: description
                type: string
              asset_group_types:
                $ref: '#/components/schemas/AssetGroupTypes'
              assets_to_add:
                type: array
                description: A list of asset ids to add to the asset group.
                items:
                  description: The ID of an asset that will be added to the asset
                    group.
                  example: '549755885175'
                  type: string
              assets_to_remove:
                type: array
                description: A list of asset ids to remove from the asset group.
                items:
                  description: The ID of an asset that will be removed from the asset
                    group.
                  example: '549755885175'
                  type: string
            required:
            - asset_group_id
    UpdateAssetGroupResponse:
      type: object
      properties:
        updated_asset_groups:
          type: array
          description: A list of successfully edited asset groups.
          items:
            $ref: '#/components/schemas/AssetGroupBinding'
        exceptions:
          type: array
          description: A list of errors associated with the asset groups. Will be
            returned if there is an error.
          nullable: true
          items:
            type: object
            properties:
              code:
                type: integer
                description: Error code associated with the error editing asset group.
                example: 29
              message:
                type: string
                description: Error message associated with the error editing asset
                  group.
                example: You are not permitted to access that resource.
              asset_group_id:
                type: string
                description: Asset group id of the exception.
                example: '666791336903426391'
    DeleteAssetGroupBody:
      description: Request body used to delete asset groups
      type: object
      required:
      - asset_groups_to_delete
      properties:
        asset_groups_to_delete:
          description: List of ids of asset groups to be deleted
          example:
          - '666791336903426391'
          - '666791336903426392'
          items:
            type: string
            pattern: ^\d+$
          type: array
          minItems: 1
          maxItems: 50
    DeleteAssetGroupResponse:
      type: object
      properties:
        deleted_asset_groups:
          type: array
          description: A list of ids of successfully deleted asset groups.
          items:
            type: string
            pattern: ^\d+$
        exceptions:
          type: array
          description: A list of errors associated with the asset groups. Will be
            returned if there is an error.
          nullable: true
          items:
            type: object
            properties:
              code:
                type: integer
                description: Error code associated with the error deleting asset group.
                example: 29
              message:
                type: string
                description: Error message associated with the error deleting asset
                  group.
                example: You are not permitted to access that resource.
              asset_group_id:
                type: string
                description: Asset group id of the exception.
                example: '666791336903426391'
    UpdateInvitesResultsResponseArray:
      type: object
      properties:
        items:
          type: array
          description: List of invite/Request action status. If there is an error,
            an exception object will be returned. If the action was successfully completed,
            an invite object will be returned.
          items:
            type: object
            properties:
              exception:
                $ref: '#/components/schemas/InviteExceptionResponse'
              invite:
                $ref: '#/components/schemas/InviteBusinessRoleBinding'
    DeleteInvitesResultsResponseArray:
      description: Response to delete invites sent to Members or Partners, if there
        is an exception, return the exception mapped with the invite id
      properties:
        items:
          description: List of invite/Request deletion status. If there is an error,
            an exception object will be returned. If the invite/request was successfully
            cancelled, an invite object will be returned for the invite that was cancelled.
          items:
            properties:
              exception:
                description: An exception object if there is an error performing the
                  cancellation. It will only be provided if there is an error.
                nullable: true
                properties:
                  invite_id:
                    description: Unique identifier of an invite.
                    pattern: ^\d+$
                    type: string
                  message:
                    type: string
                    description: Error message associated with the error in performing
                      the action on the invite/request.
                    example: Business Invite request cannot be performed on current
                      invitation status.
                type: object
              invite:
                $ref: '#/components/schemas/BaseInviteDataResponse'
            type: object
          type: array
      type: object
    UpdateMemberAssetsResultsResponseArray:
      type: object
      properties:
        items:
          type: array
          description: |-
            List of assigned/updated member asset access.
            If there is an error, an exception object will be returned. If the action was successfully completed, a response object will be returned.
          items:
            type: object
            properties:
              response:
                $ref: '#/components/schemas/UsersForIndividualAssetResponse'
    UsersForIndividualAssetResponse:
      type: object
      description: An object containing the permissions a business member has on the
        asset.
      properties:
        asset_id:
          description: Unique identifier of a business asset.
          example: '549755885175'
          type: string
          pattern: ^\d+$
        member_id:
          description: Unique identifier of the business member with asset access.
          example: '140943737684417'
          type: string
          pattern: ^\d+$
        permissions:
          $ref: '#/components/schemas/PermissionsResponse'
    UpdateMaskFieldType:
      description: The field types supported by the update mask
      example: availability
      type: string
      enum:
      - ad_link
      - adult
      - age_group
      - availability
      - average_review_rating
      - brand
      - checkout_enabled
      - color
      - condition
      - custom_label_0
      - custom_label_1
      - custom_label_2
      - custom_label_3
      - custom_label_4
      - custom_number_0
      - custom_number_1
      - custom_number_2
      - custom_number_3
      - custom_number_4
      - description
      - free_shipping_label
      - free_shipping_limit
      - gender
      - google_product_category
      - gtin
      - item_group_id
      - last_updated_time
      - link
      - material
      - min_ad_price
      - mpn
      - number_of_ratings
      - number_of_reviews
      - pattern
      - price
      - product_type
      - sale_price
      - shipping
      - shipping_height
      - shipping_weight
      - shipping_width
      - size
      - size_system
      - size_type
      - tax
      - title
      - variant_names
      - variant_values
    UpdatePartnerResultsResponseArray:
      properties:
        items:
          items:
            properties:
              exception:
                $ref: '#/components/schemas/BusinessAccessError'
              member_or_partner_id:
                example: '1234567890123'
                maxLength: 18
                nullable: true
                pattern: ^\d+$
                type: string
            type: object
          type: array
      type: object
    UserFollowingFeedType:
      description: Specifies the type of followees to be kept when filtering them.
      enum:
      - ALL
      - RANKED
      - CREATOR_ONLY
      - RANKED_CREATOR_ONLY
      example: CREATOR_ONLY
      title: UserFollowingFeedType
      type: string
      default: ALL
    UserListOperationType:
      description: User list operation type (add or remove)
      enum:
      - ADD
      - REMOVE
      example: REMOVE
      title: UserListOperationType
      type: string
    UserListType:
      description: User list type
      enum:
      - EMAIL
      - IDFA
      - MAID
      - LR_ID
      - DLX_ID
      - HASHED_PINNER_ID
      example: EMAIL
      title: UserListType
      type: string
    UserSingleAssetBinding:
      type: object
      description: An object containing the permissions a business member/partner
        has on the asset.
      properties:
        permissions:
          $ref: '#/components/schemas/PermissionsResponse'
        user:
          $ref: '#/components/schemas/BusinessAccessUserSummary'
    UserSummary:
      title: UserSummary
      type: object
      properties:
        username:
          title: username
          type: string
          description: Username
          example: username
        type:
          title: type
          type: string
          description: Always "user"
          example: user
    UserWebsiteSummary:
      title: UserWebsiteSummary
      type: object
      properties:
        website:
          title: website
          type: string
          description: Website with path or domain only
          example: mysite.test
        status:
          title: status
          type: string
          description: Status of the verification process
          example: success
        verified_at:
          title: verified_at
          type: string
          description: UTC timestamp when the verification happened - sometimes missing
          example: '2022-12-14T21:03:01.602000'
    UserWebsiteVerificationCode:
      title: UserWebsiteVerificationCode
      type: object
      properties:
        verification_code:
          title: verification_code
          type: string
          description: Code to check against the user claiming the website
          example: e1edcc1a43976c646367e9c6c9a9b7b6
        dns_txt_record:
          title: dns_txt_record
          type: string
          description: DNS TXT record to check against for the website to be claimed
          example: pinterest-site-verification=e1edcc1a43976c646367e9c6c9a9b7b6
        metatag:
          title: metatag
          type: string
          description: Metatag the verification process searchs for the website to
            be claimed
          example: <meta name="p:domain_verify" content="e1edcc1a43976c646367e9c6c9a9b7b6"/>
        filename:
          title: filename
          type: string
          description: File expected to find on the website being claimed
          example: pinterest-e1edc.html
        file_content:
          title: file_content
          type: string
          description: A full html file to upload to the website in order for it to
            be claimed
    UserWebsiteVerifyRequest:
      title: User website verification request
      description: User website verification request
      type: object
      properties:
        website:
          type: string
          example: pintest-website-12345678.test/test_1
        verification_method:
          type: string
          default: METATAG
          enum:
          - FILENAME
          - METATAG
          - DNSTXT
    VideoMetadata:
      title: Video metadata
      type: object
      properties:
        item_type:
          type: string
        cover_image_url:
          type: string
        video_url:
          type: string
          nullable: true
          description: Video url (720p). </p><strong>Note:</strong> This field is
            limited and not available to all apps.
        duration:
          type: number
          description: Duration (in milliseconds)
        height:
          type: integer
          description: Height (in pixels)
        width:
          type: integer
          description: Width (in pixels)
    VideoMetadataWithItemType:
      type: object
      properties:
        cover_image_url:
          type: string
        duration:
          type: number
          nullable: true
          description: Duration (in miliseconds). Field maybe null after creation
            due to video processing time.
        height:
          type: integer
          nullable: true
          description: Height (in pixels). Field maybe null after creation due to
            video processing time.
        video_url:
          type: string
          nullable: true
          description: |-
            Video url (720p).

            **Note:** This field is limited and not available to all apps.
        width:
          type: integer
          nullable: true
          description: Width (in pixels). Field maybe null after creation due to video
            processing time.
        item_type:
          type: string
      title: Video metadata with optional itemType information.
    PartnerType:
      enum:
      - INTERNAL
      - EXTERNAL
      example: INTERNAL
      type: string
    UpdatePartnerAssetsResult:
      type: object
      description: An object containing the permissions a business partner has on
        the asset.
      properties:
        asset_id:
          description: Unique identifier of a business asset.
          example: '549755885175'
          pattern: ^\d+$
          type: string
        asset_type:
          $ref: '#/components/schemas/AssetTypeResponse'
        partner_id:
          description: Unique identifier of a business partner.
          example: '140943737684417'
          pattern: ^\d+$
          type: string
        permissions:
          $ref: '#/components/schemas/PermissionsResponse'
    UpdatePartnerAssetsResultsResponseArray:
      type: object
      properties:
        items:
          type: array
          description: List of assigned/updated partner asset access.
          items:
            type: object
            $ref: '#/components/schemas/UpdatePartnerAssetsResult'
    SharedAudienceCommon:
      type: object
      properties:
        audience_id:
          description: Unique identifier of an audience
          example: '2542621871096'
          type: string
          pattern: ^\d+$
        operation_type:
          $ref: '#/components/schemas/OperationType'
    SharedAudience:
      type: object
      allOf:
      - $ref: '#/components/schemas/SharedAudienceCommon'
      - title: SharedAudience
        type: object
        properties:
          recipient_account_ids:
            description: List of ad account IDs to share with or revoke from.
            type: array
            items:
              type: string
              pattern: ^\d+$
        required:
        - audience_id
        - recipient_account_ids
        - operation_type
    BusinessSharedAudience:
      type: object
      allOf:
      - $ref: '#/components/schemas/SharedAudienceCommon'
      - title: BusinessSharedAudience
        type: object
        properties:
          recipient_business_ids:
            description: List of business IDs to share with or revoke from.
            type: array
            items:
              type: string
              pattern: ^\d+$
        required:
        - audience_id
        - recipient_business_ids
        - operation_type
    SharedAudienceResponseCommon:
      type: object
      nullable: true
      properties:
        audience_id:
          description: Audience ID that was shared
          example: '2542621871096'
          type: string
        permissions:
          example:
          - RESOURCE_PINNER_LIST_READER
          - RESOURCE_PINNER_LIST_OWNER
          type: array
          items:
            $ref: '#/components/schemas/Role'
    SharedAudienceResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/SharedAudienceResponseCommon'
      - title: SharedAudienceResponse
        type: object
        nullable: true
        properties:
          recipient_account_ids:
            description: Account IDs that received the audience
            example:
            - '549755885175'
            type: array
            items:
              type: string
    BusinessSharedAudienceResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/SharedAudienceResponseCommon'
      - title: BusinessSharedAudienceResponse
        type: object
        nullable: true
        properties:
          recipient_business_ids:
            description: Business IDs that received the audience
            example:
            - '549755885175'
            type: array
            items:
              type: string
    OperationType:
      type: string
      description: Operation type to share a specific audience or revoke access to
        a previously shared audience
      enum:
      - SHARE
      - REVOKE
    LeadSubscription:
      type: object
      properties:
        id:
          type: string
          pattern: ^\d+$
          description: Subscription ID.
        lead_form_id:
          type: string
          nullable: true
          pattern: ^\d+$
          description: Lead form ID.
          title: Lead form ID
        webhook_url:
          type: string
          description: Standard HTTPS webhook URL.
          title: webhook_url
        ad_account_id:
          type: string
          pattern: ^\d+$
          description: The Ad Account ID that this lead form belongs to.
        user_account_id:
          type: string
          pattern: ^\d+$
          description: User account used to subscribe lead data.
        api_version:
          type: string
          description: API version.
        cryptographic_key:
          type: string
          nullable: true
          description: Base64 encoded key for client to decrypt lead data.
        cryptographic_algorithm:
          type: string
          nullable: true
          description: Lead data encryption algorithm.
        created_time:
          type: integer
          description: Subscription creation time. Unix timestamp in milliseconds.
    LeadSubscriptionPostParamsCreate:
      type: object
      properties:
        partner_access_token:
          type: string
          description: Partner access token. Only for clients that requires authentication.
            We recommend to avoid this param.
        partner_refresh_token:
          type: string
          description: Partner refresh token. Only for clients that requires authentication.
            We recommend to avoid this param.
        partner_metadata:
          allOf:
          - type: object
            properties:
              subscriber_key:
                type: string
                description: Text field value that uniquely identifies a subscriber.
          description: Partner metadata. Only for clients that requires special handling.
            We recommend to avoid this param.
      allOf:
      - type: object
        required:
        - webhook_url
        properties:
          lead_form_id:
            type: string
            pattern: ^\d+$
            description: Lead form ID.
            title: Lead form ID
          webhook_url:
            type: string
            description: Standard HTTPS webhook URL.
            title: webhook_url
    Pinterest.Lib.Error:
      type: object
      required:
      - code
      - message
      properties:
        code:
          type: integer
        message:
          type: string
      description: Default error response
      title: Generic Error
      example:
        code: 2
        message: AdAccount not found.
  parameters:
    fetch_system_users:
      name: fetch_system_users
      in: query
      description: Fetches system users if True. Fetches regular user employees if
        False.
      required: false
      schema:
        type: boolean
        default: false
    result_limit:
      description: Max search result size
      in: query
      name: limit
      example: 4
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 50
        default: 10
    path_ad_account_id:
      name: ad_account_id
      description: Unique identifier of an ad account.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_ad_group_id:
      name: ad_group_id
      description: Unique identifier of an ad group.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_ad_id:
      name: ad_id
      description: Unique identifier of an ad.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_asset_id:
      name: asset_id
      in: path
      description: Unique identifier of a business asset.
      example: '729090764583391194'
      required: true
      schema:
        type: string
        pattern: ^\d+$
        minLength: 1
        maxLength: 20
    path_lead_form_id:
      name: lead_form_id
      in: path
      description: Unique identifier of a lead form.
      example: '1234567890123'
      required: true
      schema:
        type: string
        pattern: ^\d+$
    path_aggregated_pin_data:
      name: aggregated_pin_data
      description: Id of aggregated pin data
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
    path_audience_id:
      name: audience_id
      description: Unique identifier of an audience
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_board_id:
      name: board_id
      description: Unique identifier of a board.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
    path_board_section_id:
      name: section_id
      description: Unique identifier of a board section.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
    path_bulk_request_id:
      name: bulk_request_id
      description: Unique identifier of a bulk upsert request.
      in: path
      required: true
      schema:
        type: string
    include_details:
      name: include_details
      description: if set to True then attach the errors/details to all the requests
      in: query
      schema:
        type: boolean
        default: false
    path_billing_invoice_id:
      name: billing_invoice_id
      description: Unique identifier of a billing invoice.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_business_id:
      name: business_id
      in: path
      description: Business id
      example: '729090764583391194'
      required: true
      schema:
        type: string
        pattern: ^\d+$
        minLength: 1
        maxLength: 20
    path_business_hierarchy_id:
      name: business_hierarchy_id
      in: path
      description: business hierarchy node id
      example: '7009386637860'
      required: true
      schema:
        type: string
        pattern: ^\d+$
        minLength: 1
        maxLength: 20
    path_business_user:
      name: business_id
      in: path
      description: Unique identifier of the requesting business.
      example: '729090764583391194'
      required: true
      schema:
        type: string
        pattern: ^\d+$
        minLength: 1
        maxLength: 20
    path_business_partner_user:
      name: partner_id
      in: path
      description: The partner id to be bound to the Business
      example: '729090764583391194'
      required: true
      schema:
        type: string
        pattern: ^\d+$
        minLength: 1
        maxLength: 20
    path_business_member_user:
      name: member_id
      in: path
      description: The member id to fetch assets for.
      example: '729090764583391194'
      required: true
      schema:
        type: string
        pattern: ^\d+$
        minLength: 1
        maxLength: 20
    path_non_system_business_user:
      name: business_id
      in: path
      description: Unique identifier of the requesting business.
      example: '729090764583391194'
      required: true
      schema:
        type: string
        pattern: ^\d+$
        minLength: 1
    path_campaign_id:
      name: campaign_id
      description: Campaign ID, must be associated with the ad account ID provided
        in the path.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_catalogs_feed_id:
      description: Unique identifier of a feed
      in: path
      required: true
      name: feed_id
      schema:
        type: string
        pattern: ^\d+$
    path_catalogs_items_batch_id:
      name: batch_id
      in: path
      description: Id of a catalogs items batch to fetch
      example: 66753b9bb65c46c49bd8503b27fecf9e
      required: true
      schema:
        type: string
        pattern: ^[a-zA-Z0-9]+$
    path_catalogs_processing_result_id:
      description: Unique identifier of a feed processing result. It can be acquired
        from the "id" field of the "items" array within the response of the [List
        processing results for a given feed](/docs/api/v5/#operation/feed_processing_results/list).
      name: processing_result_id
      in: path
      example: '5224831246441439241'
      required: true
      schema:
        type: string
        pattern: ^\d+$
    path_catalogs_product_group_id:
      description: Unique identifier of a product group
      in: path
      required: true
      name: product_group_id
      schema:
        type: string
        pattern: ^\d+$
    path_category_id:
      name: category_id
      description: Category (L1 interest) numeric ID.
      in: path
      required: true
      style: simple
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_conversion_tag_id:
      description: Id of the conversion tag.
      in: path
      example: '2617998078212'
      explode: false
      name: conversion_tag_id
      required: true
      schema:
        pattern: ^\d+$
        maxLength: 18
        type: string
      style: simple
    path_customer_list_id:
      name: customer_list_id
      description: Unique identifier of a customer list
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_external_business_id:
      name: external_business_id
      description: External business ID for the integration.
      in: path
      required: true
      schema:
        type: string
    path_interest_id:
      name: interest_id
      description: Unique identifier of an interest.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_media_id:
      name: media_id
      description: Media identifier
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
    path_member_id:
      name: member_id
      in: path
      description: The member id to be bound to the Business
      example: '729090764583391194'
      required: true
      schema:
        type: string
        pattern: ^\d+$
        minLength: 1
        maxLength: 20
    path_order_line_id:
      name: order_line_id
      description: Unique identifier of an order line.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_pin_id:
      name: pin_id
      description: Unique identifier of a Pin.
      in: path
      required: true
      schema:
        type: string
    path_pin_order_id:
      description: The pin order id associated with the ssio insertion order
      in: path
      name: pin_order_id
      required: true
      schema:
        type: string
        example: 0Q01N0000015hekSVDFDC
    path_product_group_promotion_id:
      name: product_group_promotion_id
      description: Unique identifier of a product group promotion
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_promotion_id:
      name: promotion_id
      description: Unique identifier of a promotion
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_scope:
      name: scope
      description: Generated audience scope to request.
      in: path
      required: true
      style: simple
      schema:
        $ref: '#/components/schemas/AudienceDefinitionScope'
    path_subscription_id:
      name: subscription_id
      description: Unique identifier of a subscription.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
    path_targeting_type:
      name: targeting_type
      description: Public targeting type.
      in: path
      required: true
      style: simple
      schema:
        title: PublicTargetingType
        description: Public ad targeting type with external names
        type: string
        example: APPTYPE
        enum:
        - APPTYPE
        - GENDER
        - LOCALE
        - AGE_BUCKET
        - LOCATION
        - GEO
        - INTEREST
        - KEYWORD
        - AUDIENCE_INCLUDE
        - AUDIENCE_EXCLUDE
    path_template_id:
      name: template_id
      description: Unique identifier of a template.
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    path_trend_region:
      name: region
      description: |-
        The geographic region of interest. Only top trends within the specified region will be returned.<br />
        The `region` parameter is formatted as ISO 3166-2 country codes delimited by `+`, corresponding to the following geographic areas:
        - `US` - United States
        - `CA` - Canada
        - `DE` - Germany
        - `FR` - France
        - `ES` - Spain
        - `IT` - Italy
        - `DE+AT+CH` - Germanic countries
        - `GB+IE` - Great Britain & Ireland
        - `IT+ES+PT+GR+MT` - Southern Europe
        - `PL+RO+HU+SK+CZ` - Eastern Europe
        - `SE+DK+FI+NO` - Nordic countries
        - `NL+BE+LU` - Benelux
        - `AR` - Argentina
        - `BR` - Brazil
        - `CO` - Colombia
        - `MX` - Mexico
        - `MX+AR+CO+CL` - Hispanic LatAm
        - `AU+NZ` - Australasia
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/TrendsSupportedRegion'
    path_trend_type:
      name: trend_type
      description: |-
        The methodology used to rank how trendy a keyword is.
        - `growing` trends have high upward growth in search volume over the last quarter
        - `monthly` trends have high search volume in the last month
        - `yearly` trends have high search volume in the last year
        - `seasonal` trends have high upward growth in search volume over the last month and exhibit a seasonal recurring pattern (typically annual)
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/TrendType'
    path_type:
      name: type
      description: Generated audience type to request.
      in: path
      required: true
      style: simple
      schema:
        $ref: '#/components/schemas/AudienceDefinitionType'
    path_username:
      name: username
      description: A valid username
      in: path
      required: true
      schema:
        type: string
        pattern: (?!^\d+$)^.+$
        example: username
    query_ad_account_id:
      name: ad_account_id
      description: Unique identifier of an ad account.
      in: query
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    query_ad_group_id:
      description: Ad group Id.
      in: query
      name: ad_group_id
      example: '123123123'
      required: false
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    query_ad_group_ids:
      description: List of Ad group Ids to use to filter the results.
      in: query
      name: ad_group_ids
      required: false
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
        minItems: 1
        maxItems: 100
    query_ad_group_ids_required:
      description: List of Ad group Ids to use to filter the results.
      in: query
      name: ad_group_ids
      required: true
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
          maxLength: 18
        minItems: 1
        maxItems: 100
    query_ad_group_targeting_types:
      name: targeting_types
      description: Targeting type breakdowns for the report. The reporting per targeting
        type <br> is independent from each other. ["AGE_BUCKET_AND_GENDER", "CREATIVE_ENHANCEMENTS"]
        are in BETA and not yet available to all users.
      required: true
      explode: false
      in: query
      schema:
        items:
          $ref: '#/components/schemas/AdsAnalyticsAdGroupTargetingType'
        maxItems: 14
        minItems: 1
        type: array
    query_ad_ids:
      description: List of Ad Ids to use to filter the results.
      in: query
      name: ad_ids
      required: false
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
        minItems: 1
        maxItems: 100
    query_ad_ids_required:
      description: List of Ad Ids to use to filter the results.
      in: query
      name: ad_ids
      required: true
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
        minItems: 1
        maxItems: 100
    query_ad_targeting_types:
      name: targeting_types
      description: Targeting type breakdowns for the report. The reporting per targeting
        type <br> is independent from each other. ["AGE_BUCKET_AND_GENDER"] is in
        BETA and not yet available to all users.
      required: true
      explode: false
      in: query
      schema:
        items:
          $ref: '#/components/schemas/AdsAnalyticsAdTargetingType'
        maxItems: 14
        minItems: 1
        type: array
    query_age_bucket_list:
      name: ages
      description: |-
        If set, filters the results to trends among users in the specified age range(s).<br />
        If unset, trends among all age groups will be returned.
      example:
      - 35-44
      - 50-54
      in: query
      required: false
      schema:
        $ref: '#/components/schemas/AgeBucketList'
    query_app_types:
      description: Apps or devices to get data for, default is all.
      in: query
      name: app_types
      required: false
      schema:
        default: ALL
        enum:
        - ALL
        - MOBILE
        - TABLET
        - WEB
        type: string
    query_assets_summary:
      name: assets_summary
      description: |-
        Include assets summary in the response if this is true.

        The assets summary returns a dictionary representing a summary of the assets
        for the business user ID, with information like the ad accounts and profiles
        the user has permissions for and what those permissions are
      in: query
      required: false
      schema:
        type: boolean
        default: false
    query_attribution_types:
      name: attribution_types
      description: List of types of attribution for the conversion report
      required: false
      explode: false
      in: query
      schema:
        $ref: '#/components/schemas/ConversionReportAttributionType'
    query_audience_id:
      description: Unique identifier of the audience to use to filter the results.
      in: query
      name: audience_id
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    query_audience_ids:
      description: List of audience ids to use to filter the results.
      in: query
      name: audience_ids
      required: false
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
        minItems: 1
        maxItems: 100
    query_audience_insight_type:
      description: Type of audience insights.
      explode: false
      in: query
      name: audience_insight_type
      required: true
      schema:
        $ref: '#/components/schemas/AudienceInsightType'
    query_audience_type:
      description: The type of audience to filter for.
      in: query
      name: audience_type
      required: false
      schema:
        type: string
        pattern: ^\d+$
    query_audience_types:
      description: The types of audience to filter for.
      in: query
      name: audience_types
      required: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/AudienceType'
        minItems: 1
        maxItems: 100
    query_billing_document_type:
      name: document_type
      in: query
      description: Document type of billing invoices to filter by
      required: false
      schema:
        type: string
        example: INVOICE
        enum:
        - INVOICE
        - CREDIT_MEMO
    query_billing_end_due_date:
      name: end_due_date
      in: query
      description: 'Ending point for due dates when searching for invoices. Format:
        YYYY-MM-DD'
      required: false
      schema:
        type: string
        format: date
        example: '2024-01-01'
        pattern: ^(\d{4})-(\d{2})-(\d{2})$
    query_billing_invoice_status:
      name: status
      in: query
      description: Status of billing invoices to filter by
      required: false
      schema:
        type: string
        example: OPEN
        enum:
        - OPEN
        - CLOSED
    query_billing_start_due_date:
      name: start_due_date
      in: query
      description: 'Starting point for due dates when searching for invoices. Format:
        YYYY-MM-DD'
      required: false
      schema:
        type: string
        format: date
        example: '2023-01-01'
        pattern: ^(\d{4})-(\d{2})-(\d{2})$
    query_bookmark:
      name: bookmark
      description: Cursor used to fetch the next page of items
      in: query
      required: false
      schema:
        type: string
    query_campaign_id:
      description: Campaign Id to use to filter the results.
      in: query
      name: campaign_id
      required: false
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    query_campaign_id_required:
      description: Campaign Id to use to filter the results.
      in: query
      name: campaign_id
      required: true
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    query_campaign_ids:
      description: List of Campaign Ids to use to filter the results.
      in: query
      name: campaign_ids
      required: false
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
          maxLength: 18
        minItems: 1
        maxItems: 100
    query_campaign_ids_required:
      description: List of Campaign Ids to use to filter the results.
      in: query
      name: campaign_ids
      required: true
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
          maxLength: 18
        minItems: 1
        maxItems: 100
    query_campaign_targeting_types:
      name: targeting_types
      description: Targeting type breakdowns for the report. The reporting per targeting
        type <br> is independent from each other. ["AGE_BUCKET_AND_GENDER"] is in
        BETA and not yet available to all users.
      required: true
      explode: false
      in: query
      schema:
        items:
          $ref: '#/components/schemas/AdsAnalyticsCampaignTargetingType'
        maxItems: 14
        minItems: 1
        type: array
    query_catalogs_catalog_id:
      description: Filter entities for a given catalog_id. If not given, all catalogs
        are considered.
      in: query
      required: false
      name: catalog_id
      schema:
        type: string
        pattern: ^\d+$
    query_catalogs_report_stats_parameters:
      name: parameters
      in: query
      description: Contains the parameters for report identification.
      required: true
      style: deepObject
      schema:
        type: object
        description: Report stats parameters
        properties:
          catalog_type:
            $ref: '#/components/schemas/CatalogsType'
        required:
        - catalog_type
        oneOf:
        - $ref: '#/components/schemas/CatalogsRetailReportStatsParameters'
        - $ref: '#/components/schemas/CatalogsHotelReportStatsParameters'
        discriminator:
          propertyName: catalog_type
          mapping:
            RETAIL: '#/components/schemas/CatalogsRetailReportStatsParameters'
            HOTEL: '#/components/schemas/CatalogsHotelReportStatsParameters'
    query_catalogs_feed_id:
      description: Filter entities for a given feed_id. If not given, all feeds are
        considered.
      in: query
      required: false
      name: feed_id
      schema:
        type: string
        pattern: ^\d+$
    query_catalogs_item_numbers:
      name: item_numbers
      in: query
      description: Item number based on order of appearance in the Catalogs Feed.
        For example, '0' refers to first item found in a feed that was downloaded
        from a 'location' specified during feed creation.
      example:
      - 1
      - 5
      required: false
      schema:
        type: array
        items:
          type: integer
    query_catalogs_item_validation_issue:
      name: item_validation_issue
      in: query
      description: Filter item validation issues that have a given type of item validation
        issue.
      example: TITLE_MISSING
      required: false
      schema:
        $ref: '#/components/schemas/CatalogsItemValidationIssue'
    query_catalogs_items_country:
      name: country
      in: query
      description: Country for the Catalogs Items
      example: US
      required: true
      schema:
        type: string
    query_catalogs_items_filters:
      name: filters
      in: query
      description: Identifies items to be retrieved. This is a required parameter.
      required: false
      style: deepObject
      schema:
        $ref: '#/components/schemas/CatalogsItemsFilters'
    query_catalogs_items_language:
      name: language
      in: query
      description: Language for the Catalogs Items
      example: EN
      required: true
      schema:
        type: string
    query_catalogs_report_token:
      name: token
      description: Token returned from async build report call
      in: query
      required: true
      schema:
        type: string
    query_catalogs_product_group_ids:
      name: id
      in: query
      style: form
      explode: false
      description: Comma-separated list of product group ids
      required: false
      schema:
        type: array
        items:
          type: integer
        minItems: 1
        maxItems: 1000
    query_catalogs_product_group_ids_required:
      name: id
      in: query
      style: form
      explode: false
      description: Comma-separated list of product group ids
      required: true
      schema:
        type: array
        items:
          type: integer
        minItems: 1
        maxItems: 1000
    query_client_id:
      name: client_id
      description: Client ID.
      in: query
      required: false
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
        example: '1094834'
      style: form
    query_columns:
      description: 'Columns to retrieve, encoded as a comma-separated string. **NOTE**:
        Any metrics defined as MICRO_DOLLARS returns a value based on the advertiser
        profile''s currency field. For USD,($1/1,000,000, or $0.000001 - one one-ten-thousandth
        of a cent). it''s microdollars. Otherwise, it''s in microunits of the advertiser''s
        currency.<br/>For example, if the advertiser''s currency is GBP (British pound
        sterling), all MICRO_DOLLARS fields will be in GBP microunits (1/1,000,000
        British pound).<br/>If a column has no value, it may not be returned'
      explode: false
      in: query
      name: columns
      required: true
      schema:
        items:
          type: string
          description: Reporting columns for sync reporting endpoints
          example: TOTAL_CONVERSIONS
          enum:
          - SPEND_IN_MICRO_DOLLAR
          - PAID_IMPRESSION
          - SPEND_IN_DOLLAR
          - CPC_IN_MICRO_DOLLAR
          - ECPC_IN_MICRO_DOLLAR
          - ECPC_IN_DOLLAR
          - CTR
          - ECTR
          - OUTBOUND_CTR_1
          - CAMPAIGN_NAME
          - CAMPAIGN_BRAND_LABEL
          - PIN_ID
          - TOTAL_ENGAGEMENT
          - ENGAGEMENT_1
          - ENGAGEMENT_2
          - ECPE_IN_DOLLAR
          - ENGAGEMENT_RATE
          - EENGAGEMENT_RATE
          - ECPM_IN_MICRO_DOLLAR
          - REPIN_RATE
          - CTR_2
          - CAMPAIGN_ID
          - ADVERTISER_ID
          - AD_ACCOUNT_ID
          - PIN_PROMOTION_ID
          - AD_ID
          - AD_GROUP_ID
          - CAMPAIGN_ENTITY_STATUS
          - CAMPAIGN_OBJECTIVE_TYPE
          - CPM_IN_MICRO_DOLLAR
          - CPM_IN_DOLLAR
          - AD_GROUP_NAME
          - AD_GROUP_BUDGET_TYPE
          - AD_GROUP_BUDGET_IN_LOCAL_CURRENCY
          - AD_GROUP_ENTITY_STATUS
          - AD_GROUP_BID_MULTIPLIER
          - PROMO_ID
          - PROMO_NAME
          - ORDER_LINE_ID
          - ORDER_LINE_NAME
          - CLICKTHROUGH_1
          - REPIN_1
          - IMPRESSION_1
          - IMPRESSION_1_GROSS
          - CLICKTHROUGH_1_GROSS
          - OUTBOUND_CLICK_1
          - CLICKTHROUGH_2
          - REPIN_2
          - IMPRESSION_2
          - OUTBOUND_CLICK_2
          - TOTAL_CLICKTHROUGH
          - TOTAL_IMPRESSION
          - TOTAL_IMPRESSION_USER
          - TOTAL_IMPRESSION_FREQUENCY
          - COST_PER_OUTBOUND_CLICK_IN_DOLLAR
          - COST_PER_OUTBOUND_CLICK_IN_DOLLAR_1
          - TOTAL_ENGAGEMENT_SIGNUP
          - TOTAL_ENGAGEMENT_CHECKOUT
          - TOTAL_ENGAGEMENT_LEAD
          - TOTAL_CLICK_SIGNUP
          - TOTAL_CLICK_CHECKOUT
          - TOTAL_CLICK_ADD_TO_CART
          - TOTAL_CLICK_LEAD
          - TOTAL_VIEW_SIGNUP
          - TOTAL_VIEW_CHECKOUT
          - TOTAL_VIEW_ADD_TO_CART
          - TOTAL_VIEW_LEAD
          - TOTAL_CONVERSIONS
          - TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR
          - TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
          - TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR
          - TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
          - TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR
          - TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
          - TOTAL_WEB_SESSIONS
          - WEB_SESSIONS_1
          - WEB_SESSIONS_2
          - AD_NAME
          - CAMPAIGN_LIFETIME_SPEND_CAP
          - AD_GROUP_OPTIMIZATION
          - CAMPAIGN_DAILY_SPEND_CAP
          - CAMPAIGN_BUDGET_OPTIMIZATION
          - IS_PREMIERE_CAMPAIGN
          - TOTAL_PAGE_VISIT
          - TOTAL_SIGNUP
          - TOTAL_CHECKOUT
          - TOTAL_CUSTOM
          - TOTAL_LEAD
          - TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR
          - TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR
          - TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR
          - PAGE_VISIT_COST_PER_ACTION
          - PAGE_VISIT_ROAS
          - CHECKOUT_ROAS
          - CUSTOM_ROAS
          - PRODUCT_GROUP_AD_IMAGE_TAG
          - PRODUCT_GROUP_AD_VIDEO_TAG
          - VIDEO_MRC_VIEWS_1
          - VIDEO_3SEC_VIEWS_2
          - VIDEO_P100_COMPLETE_2
          - VIDEO_P0_COMBINED_2
          - VIDEO_P25_COMBINED_2
          - VIDEO_P50_COMBINED_2
          - VIDEO_P75_COMBINED_2
          - VIDEO_P95_COMBINED_2
          - VIDEO_MRC_VIEWS_2
          - PAID_VIDEO_VIEWABLE_RATE
          - VIDEO_LENGTH
          - VIDEO_SPEND_IN_DOLLAR
          - ECPV_IN_DOLLAR
          - ECPCV_IN_DOLLAR
          - ECPCV_P95_IN_DOLLAR
          - TOTAL_VIDEO_3SEC_VIEWS
          - TOTAL_VIDEO_P100_COMPLETE
          - TOTAL_VIDEO_P0_COMBINED
          - TOTAL_VIDEO_P25_COMBINED
          - TOTAL_VIDEO_P50_COMBINED
          - TOTAL_VIDEO_P75_COMBINED
          - TOTAL_VIDEO_P95_COMBINED
          - TOTAL_VIDEO_MRC_VIEWS
          - TOTAL_VIDEO_AVG_WATCHTIME_IN_SECOND
          - TOTAL_REPIN_RATE
          - WEB_CHECKOUT_COST_PER_ACTION
          - WEB_CHECKOUT_ROAS
          - TOTAL_WEB_CHECKOUT
          - TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR
          - TOTAL_WEB_CLICK_CHECKOUT
          - TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR
          - TOTAL_WEB_ENGAGEMENT_CHECKOUT
          - TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR
          - TOTAL_WEB_VIEW_CHECKOUT
          - TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR
          - INAPP_CHECKOUT_COST_PER_ACTION
          - TOTAL_OFFLINE_CHECKOUT
          - IDEA_PIN_PRODUCT_TAG_VISIT_1
          - IDEA_PIN_PRODUCT_TAG_VISIT_2
          - TOTAL_IDEA_PIN_PRODUCT_TAG_VISIT
          - LEADS
          - COST_PER_LEAD
          - QUIZ_COMPLETED
          - QUIZ_PIN_RESULT_OPEN
          - QUIZ_COMPLETION_RATE
          - SHOWCASE_PIN_CLICKTHROUGH
          - SHOWCASE_SUBPAGE_CLICKTHROUGH
          - SHOWCASE_SUBPIN_CLICKTHROUGH
          - SHOWCASE_SUBPAGE_IMPRESSION
          - SHOWCASE_SUBPIN_IMPRESSION
          - SHOWCASE_SUBPAGE_SWIPE_LEFT
          - SHOWCASE_SUBPAGE_SWIPE_RIGHT
          - SHOWCASE_SUBPIN_SWIPE_LEFT
          - SHOWCASE_SUBPIN_SWIPE_RIGHT
          - SHOWCASE_SUBPAGE_REPIN
          - SHOWCASE_SUBPIN_REPIN
          - SHOWCASE_SUBPAGE_CLOSEUP
          - SHOWCASE_CARD_THUMBNAIL_SWIPE_FORWARD
          - SHOWCASE_CARD_THUMBNAIL_SWIPE_BACKWARD
          - SHOWCASE_AVERAGE_SUBPAGE_CLOSEUP_PER_SESSION
          - TOTAL_CHECKOUT_CONVERSION_RATE
          - TOTAL_VIEW_CATEGORY_CONVERSION_RATE
          - TOTAL_ADD_TO_CART_CONVERSION_RATE
          - TOTAL_SIGNUP_CONVERSION_RATE
          - TOTAL_PAGE_VISIT_CONVERSION_RATE
          - TOTAL_LEAD_CONVERSION_RATE
          - TOTAL_SEARCH_CONVERSION_RATE
          - TOTAL_WATCH_VIDEO_CONVERSION_RATE
          - TOTAL_UNKNOWN_CONVERSION_RATE
          - TOTAL_CUSTOM_CONVERSION_RATE
        type: array
    query_comment_feed_type:
      name: feed_type
      description: Comment feed type.
      in: query
      schema:
        type: string
        enum:
        - ranked
        - recent
        default: recent
    query_content_type:
      description: Filter to paid or organic data. Default is all.
      in: query
      name: content_type
      required: false
      schema:
        default: ALL
        enum:
        - ALL
        - PAID
        - ORGANIC
        type: string
    query_conversion_attribution_click_window_days:
      name: click_window_days
      in: query
      schema:
        type: integer
        enum:
        - 0
        - 1
        - 7
        - 14
        - 30
        - 60
        default: 30
      description: Number of days to use as the conversion attribution window for
        a pin click action. Applies to Pinterest Tag conversion metrics. Prior conversion
        tags use their defined attribution windows. If not specified, defaults to
        `30` days.
      example: 1
    query_conversion_attribution_conversion_report_time:
      description: 'The date by which the conversion metrics returned from this endpoint
        will be reported. There are two dates associated with a conversion event:
        the date that the user interacted with the ad, and the date that the user
        completed a conversion event.'
      example: TIME_OF_AD_ACTION
      in: query
      name: conversion_report_time
      schema:
        type: string
        enum:
        - TIME_OF_AD_ACTION
        - TIME_OF_CONVERSION
        default: TIME_OF_AD_ACTION
    query_conversion_attribution_engagement_window_days:
      name: engagement_window_days
      in: query
      description: Number of days to use as the conversion attribution window for
        an engagement action. Engagements include saves, closeups, link clicks, and
        carousel card swipes. Applies to Pinterest Tag conversion metrics. Prior conversion
        tags use their defined attribution windows. If not specified, defaults to
        `30` days.<br> <strong>Note:</strong> This parameter no longer returns new
        data. However, you can still access historic data through <strong>Sept 30,
        2027</strong>.
      schema:
        type: integer
        enum:
        - 0
        - 1
        - 7
        - 14
        - 30
        - 60
        default: 30
    query_conversion_attribution_view_window_days:
      name: view_window_days
      in: query
      description: Number of days to use as the conversion attribution window for
        a view action. Applies to Pinterest Tag conversion metrics. Prior conversion
        tags use their defined attribution windows. If not specified, defaults to
        `1` day.
      schema:
        type: integer
        enum:
        - 0
        - 1
        - 7
        - 14
        - 30
        - 60
        default: 1
    query_country_code:
      name: country_code
      description: Two letter country code (ISO 3166-1 alpha-2)
      in: query
      example: US
      required: true
      explode: true
      schema:
        type: string
      style: form
    query_created_in_last_n_days:
      name: created_in_last_n_days
      in: query
      schema:
        type: integer
        enum:
        - 30
      description: Get metrics for pins created in the last "n" days.
      example: 30
    query_creative_types:
      in: query
      name: creative_types
      required: false
      description: Pin creative types filter. </p><strong>Note:</strong> SHOP_THE_PIN
        has been deprecated. Please use COLLECTION instead.
      schema:
        type: array
        items:
          type: string
          example: REGULAR
          enum:
          - REGULAR
          - VIDEO
          - SHOPPING
          - CAROUSEL
          - MAX_VIDEO
          - SHOP_THE_PIN
          - COLLECTION
          - IDEA
    query_end_date:
      description: 'Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more
        than 90 days past start_date.'
      in: query
      name: end_date
      required: true
      schema:
        type: string
        format: date
    query_end_date_async:
      description: 'Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more
        than 2.5 years past start date.'
      in: query
      name: end_date
      required: false
      schema:
        type: string
        format: date
    query_entity_statuses:
      in: query
      name: entity_statuses
      required: false
      description: Entity status
      schema:
        type: array
        items:
          type: string
          example: ACTIVE
          enum:
          - ACTIVE
          - PAUSED
          - ARCHIVED
          - DRAFT
          - DELETED_DRAFT
        default:
        - ACTIVE
        - PAUSED
    query_entity_ids:
      description: List of entity Ids to use to filter the results.
      in: query
      name: entity_ids
      required: false
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
          maxLength: 18
        minItems: 1
        maxItems: 100
    query_schedule_statuses:
      name: schedule_statuses
      in: query
      required: false
      description: Specifies which schedules to return based on their status.
      schema:
        type: array
        items:
          type: string
          example: ACTIVE
          enum:
          - DRAFT
          - CREATED
          - SCHEDULED
          - ACTIVE
          - COMPLETED
          - FAILED
          - CANCELED
    query_schedule_types:
      name: schedule_type
      in: query
      required: false
      description: Specifies which schedules to return based on their type.
      schema:
        type: array
        items:
          type: string
          example: CAMPAIGN_BUDGET
          enum:
          - CAMPAIGN_BUDGET
          - CAMPAIGN_BID_MULTIPLIERS
    query_explicit_following:
      description: Whether or not to include implicit user follows, which means followees
        with board follows. When explicit_following is True, it means we only want
        explicit user follows.
      in: query
      name: explicit_following
      required: false
      schema:
        type: boolean
        default: false
    query_filter_deleted:
      name: filter_deleted
      description: Filter out deleted tags.
      in: query
      required: false
      schema:
        type: boolean
        example: true
        default: false
    query_flatten_rule:
      description: Uniform the format of Audiences rules for presentation on Web UI.
      in: query
      name: flatten_rule
      required: false
      schema:
        type: boolean
    query_from_claimed_content:
      description: Filter on Pins that match your claimed domain.
      in: query
      name: from_claimed_content
      required: false
      schema:
        default: BOTH
        enum:
        - OTHER
        - CLAIMED
        - BOTH
        type: string
    query_gender_list:
      name: genders
      description: |-
        If set, filters the results to trends among users who identify with the specified gender(s).<br />
        If unset, trends among all genders will be returned.<br />
        The `unknown` group includes users with unspecified or customized gender profile settings.
      example:
      - female
      - unknown
      in: query
      required: false
      schema:
        $ref: '#/components/schemas/GenderList'
    query_granularity:
      description: TOTAL - metrics are aggregated over the specified date range.<br>
        DAY - metrics are broken down daily.<br> HOUR - metrics are broken down hourly.<br>WEEKLY
        - metrics are broken down weekly.<br>MONTHLY - metrics are broken down monthly
      example: DAY
      in: query
      name: granularity
      required: true
      schema:
        $ref: '#/components/schemas/Granularity'
    query_granularity_async:
      description: TOTAL - metrics are aggregated over the specified date range.<br>
        DAY - metrics are broken down daily.<br> HOUR - metrics are broken down hourly.<br>WEEKLY
        - metrics are broken down weekly.<br>MONTHLY - metrics are broken down monthly
      example: DAY
      in: query
      name: granularity
      required: false
      schema:
        $ref: '#/components/schemas/Granularity'
    query_include_html:
      description: Return HTML in TOS text.
      explode: true
      in: query
      name: include_html
      required: false
      schema:
        default: false
        type: boolean
      style: form
    query_include_protected_pins:
      name: include_protected_pins
      description: Specify if return pins from protected boards
      required: false
      in: query
      schema:
        type: boolean
        default: false
    query_include_shared_accounts:
      in: query
      description: Include shared ad accounts
      name: include_shared_accounts
      required: false
      schema:
        type: boolean
        default: true
    query_input_term:
      description: Input term.
      in: query
      name: term
      example: sports
      required: true
      schema:
        type: string
    query_interest_list:
      name: interests
      description: |-
        If set, filters the results to trends associated with the specified interests.<br />
        If unset, trends for all interests will be returned.<br />
        The list of supported interests is:
        - `animals` - Animals
        - `architecture` - Architecture
        - `art` - Art
        - `beauty` - Beauty
        - `childrens_fashion` - Children's Fashion
        - `design` - Design
        - `diy_and_crafts` - DIY & Crafts
        - `education` - Education
        - `electronics` - Electronics
        - `entertainment` - Entertainment
        - `event_planning` - Event Planning
        - `finance` - Finance
        - `food_and_drinks` - Food & Drink
        - `gardening` - Gardening
        - `health` - Health
        - `home_decor` - Home Decor
        - `mens_fashion` - Men's Fashion
        - `parenting` - Parenting
        - `quotes` - Quotes
        - `sport` - Sports
        - `travel` - Travel
        - `vehicles` - Vehicles
        - `wedding` - Wedding
        - `womens_fashion` - Women's Fashion
      example:
      - beauty
      - womens_fashion
      in: query
      required: false
      schema:
        $ref: '#/components/schemas/L1InterestList'
    query_is_member:
      name: is_member
      description: A boolean field to indicate whether the invite is to create a partnership
        or a membership.
      in: query
      required: false
      schema:
        type: boolean
        default: true
    query_keywords:
      name: keywords
      description: Comma-separated keywords
      in: query
      required: true
      explode: false
      schema:
        items:
          type: string
        maxItems: 2000
        minItems: 1
        type: array
      style: form
    query_pin_metrics:
      name: pin_metrics
      description: Specify whether to return 90d and lifetime Pin metrics. Total comments
        and total reactions are only available with lifetime Pin metrics. If Pin was
        created before <code>2023-03-20</code> lifetime metrics will only be available
        for Video and Idea Pin formats. Lifetime metrics are available for all Pin
        formats since then.
      in: query
      required: false
      schema:
        type: boolean
        default: false
    query_label_entity_statuses:
      in: query
      name: entity_statuses
      required: false
      description: Label entity status
      schema:
        type: array
        items:
          type: string
          example: ACTIVE
          enum:
          - ACTIVE
          - ARCHIVED
        default:
        - ACTIVE
    query_label_ids:
      description: List of Label Ids to use to filter the results.
      in: query
      name: label_ids
      required: false
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
          maxLength: 18
        minItems: 1
        maxItems: 100
    query_label_types:
      in: query
      name: label_types
      required: false
      description: Label type.
      schema:
        type: array
        items:
          type: string
          example: BRAND
          enum:
          - BRAND
          - CUSTOM
        example:
        - BRAND
        - CUSTOM
        default:
        - BRAND
        - CUSTOM
    query_list_input_terms:
      description: List of input terms.
      in: query
      name: terms
      required: true
      schema:
        type: array
        items:
          type: string
          example: workout
    query_match_types:
      explode: true
      description: Keyword <a target="_blank" href="/docs/api-features/targeting-overview/">match
        type</a>
      in: query
      name: match_types
      required: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/MatchType'
        minItems: 1
        maxItems: 5
    query_members:
      name: members
      in: query
      description: A list of business members ids separated by comma to filter the
        results. Only members with the specified ids will be returned.
      example: 00101010101,2222220101
      required: false
      schema:
        type: string
    query_partners:
      name: partners
      in: query
      description: A list of business partners ids separated by comma.
      example: 00101010101,2222220101
      required: false
      schema:
        type: string
    query_metric_types:
      description: 'Metric types to get data for, default is all. '
      explode: false
      in: query
      name: metric_types
      required: false
      schema:
        items:
          enum:
          - ENGAGEMENT
          - ENGAGEMENT_RATE
          - IMPRESSION
          - OUTBOUND_CLICK
          - OUTBOUND_CLICK_RATE
          - PIN_CLICK
          - PIN_CLICK_RATE
          - SAVE
          - SAVE_RATE
          type: string
        type: array
      style: form
    query_normalize_against_group:
      name: normalize_against_group
      description: |-
        Governs how the resulting time series data will be normalized to a [0-100] scale.<br />
        By default (`false`), the data will be normalized independently for each keyword.  The peak search volume observation in *each* keyword's time series will be represented by the value 100.  This is ideal for analyzing when an individual keyword is expected to peak in interest.<br />
        If set to `true`, the data will be normalized as a group.  The peak search volume observation across *all* keywords in the response will be represented by the value 100, and all other values scaled accordingly.  Use this option when you wish to compare relative search volume between multiple keywords.
      in: query
      required: false
      schema:
        type: boolean
        example: true
        default: false
    query_num_of_pins:
      name: num_of_pins
      in: query
      schema:
        type: integer
        minimum: 1
        maximum: 50
        default: 10
      description: Number of pins to include, default is 10. Max is 50.
      example: 25
    query_oauth_signature:
      name: oauth_signature
      description: Oauth signature
      in: query
      required: false
      schema:
        type: string
        example: 8209f
      style: form
    query_order:
      description: "The order in which to sort the items returned: \u201CASCENDING\u201D\
        \ or \u201CDESCENDING\u201D\nby ID. Note that higher-value IDs are associated\
        \ with more-recently added\nitems."
      in: query
      name: order
      required: false
      schema:
        type: string
        example: ASCENDING
        enum:
        - ASCENDING
        - DESCENDING
    query_order_by:
      description: The audience field to order results by.
      in: query
      name: order_by
      required: false
      schema:
        $ref: '#/components/schemas/GetAudiencesOrderBy'
    query_page_size:
      name: page_size
      description: Maximum number of items to include in a single page of the response.
        See documentation on <a href='/docs/reference/pagination/'>Pagination</a>
        for more information.
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 250
        default: 25
    query_pin_analytics_metric_types:
      description: Pin metric types to get data for. VIDEO_MRC_VIEW are Video views,
        VIDEO_V50_WATCH_TIME is Total play time. If Pin was created before <code>2023-03-20</code>,
        Profile visits and Follows will only be available for Idea Pins. These metrics
        are available for all Pin formats since then. Keep in mind this cannot have
        ALL if split_field is set to any value other than <code>NO_SPLIT</code>.
      explode: false
      in: query
      name: metric_types
      required: true
      schema:
        type: array
        items:
          oneOf:
          - description: Standard Pin metric types
            type: string
            enum:
            - IMPRESSION
            - OUTBOUND_CLICK
            - PIN_CLICK
            - SAVE
            - SAVE_RATE
            - TOTAL_COMMENTS
            - TOTAL_REACTIONS
            - USER_FOLLOW
            - PROFILE_VISIT
          - description: Video Pin metric types
            type: string
            enum:
            - IMPRESSION
            - OUTBOUND_CLICK
            - PIN_CLICK
            - SAVE
            - SAVE_RATE
            - VIDEO_MRC_VIEW
            - VIDEO_10S_VIEW
            - QUARTILE_95_PERCENT_VIEW
            - VIDEO_V50_WATCH_TIME
            - VIDEO_START
            - VIDEO_AVG_WATCH_TIME
            - TOTAL_COMMENTS
            - TOTAL_REACTIONS
      style: form
    query_pin_filter:
      name: pin_filter
      description: Pin filter.
      required: false
      in: query
      schema:
        type: string
        enum:
        - exclude_native
        - exclude_repins
        - has_been_promoted
    query_pin_format:
      description: Pin formats to get data for, default is all.
      in: query
      name: pin_format
      required: false
      schema:
        default: ALL
        enum:
        - ALL
        - ORGANIC_IMAGE
        - ORGANIC_PRODUCT
        - ORGANIC_VIDEO
        - ADS_STANDARD
        - ADS_PRODUCT
        - ADS_VIDEO
        - ADS_IDEA
        type: string
    query_pin_order_id:
      description: The pin order id associated with the ssio insertino order
      in: query
      name: pin_order_id
      required: false
      schema:
        type: string
        example: 0Q01N0000015hekSVDFDC
    query_pin_type:
      name: pin_type
      description: The type of pins to return, currently only enabled for private
        pins
      required: false
      in: query
      schema:
        type: string
        enum:
        - PRIVATE
    query_product_group_ids_required:
      description: List of Product group Ids to use to filter the results.
      in: query
      name: product_group_ids
      required: true
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
        minItems: 1
        maxItems: 100
    query_product_group_promotion_ids:
      description: List of Product group promotion Ids.
      in: query
      name: product_group_promotion_ids
      required: false
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
        minItems: 1
        maxItems: 100
    query_query:
      description: Search query. Can contain pin description keywords or comma-separated
        pin IDs.
      in: query
      name: query
      required: false
      schema:
        type: string
    query_account_type:
      description: Filter accounts by account type.
      in: query
      name: account_type
      required: true
      schema:
        $ref: '#/components/schemas/AudienceAccountType'
    query_report_type:
      name: report_type
      description: Report type.
      in: query
      required: false
      schema:
        type: string
        enum:
        - SYNC
        - ASYNC
    query_required_pin_ids:
      name: pin_ids
      description: List of Pin IDs.
      in: query
      required: true
      schema:
        type: array
        items:
          type: string
          pattern: ^\d+$
        minItems: 1
        maxItems: 100
    query_required_search_query:
      description: Search query. Can contain pin description keywords or comma-separated
        pin IDs.
      in: query
      example: Plants
      name: query
      required: true
      schema:
        type: string
    query_resource_type:
      name: asset_type
      in: query
      required: false
      description: A resource type to filter the assets by. Only assets of the specified
        type will be returned.
      schema:
        type: string
        enum:
        - AD_ACCOUNT
        - PROFILE
        - ASSET_GROUP
        - CATALOG
        - CONSUMER
        default: AD_ACCOUNT
        example: AD_ACCOUNT
    query_search_query:
      description: String keywords to search for audiences by.
      in: query
      name: search_query
      required: false
      schema:
        type: string
    query_sort:
      description: Sort method. Only RATIO is supported.
      explode: false
      in: query
      name: sort
      required: false
      schema:
        default: RATIO
        type: string
        example: RATIO
        enum:
        - RATIO
    query_sort_billing_invoice:
      name: sort
      in: query
      description: Field of which to sort billing invoices
      required: false
      schema:
        type: string
        example: DUE_DATE
        default: DUE_DATE
        enum:
        - DUE_DATE
        - BILLING_PERIOD
        - DOCUMENT_TYPE
        - TOTAL_AMOUNT
        - INVOICE_NUMBER
    query_sort_by:
      description: Specify sorting order for metrics
      explode: false
      in: query
      name: sort_by
      required: true
      schema:
        enum:
        - ENGAGEMENT
        - IMPRESSION
        - OUTBOUND_CLICK
        - PIN_CLICK
        - SAVE
        type: string
    query_source:
      description: Filter to activity from Pins created and saved by your, or activity
        created and saved by others from your claimed accounts
      in: query
      name: source
      required: false
      schema:
        default: ALL
        enum:
        - ALL
        - YOUR_PINS
        - OTHER_PINS
        type: string
    query_split_field_pins:
      description: How to split the data into groups. Not including this param means
        data won't be split.
      required: false
      in: query
      explode: false
      name: split_field
      schema:
        default: NO_SPLIT
        enum:
        - NO_SPLIT
        - APP_TYPE
        type: string
    query_split_field_user_account:
      description: How to split the data into groups. Not including this param means
        data won't be split.
      required: false
      in: query
      explode: false
      name: split_field
      schema:
        default: NO_SPLIT
        enum:
        - NO_SPLIT
        - APP_TYPE
        - OWNED_CONTENT
        - SOURCE
        - PIN_FORMAT
        type: string
    query_start_date:
      description: 'Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be
        more than 90 days back from today.'
      in: query
      name: start_date
      required: true
      schema:
        type: string
        format: date
    query_start_date_async:
      description: 'Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be
        more than 2.5 years back from today.'
      in: query
      name: start_date
      required: false
      schema:
        type: string
        format: date
    query_start_index:
      description: The starting index for returned list.
      in: query
      name: start_index
      required: false
      schema:
        type: string
        pattern: ^\d+$
    query_business_access_start_index:
      name: start_index
      in: query
      description: An index to start fetching the results from. Only the results starting
        from this index will be returned.
      example: 0
      required: false
      schema:
        type: integer
        minimum: 0
        default: 0
    query_business_partner_type:
      name: partner_type
      in: query
      description: |-
        Specifies whether to fetch internal or external (shared) partners.
        If partner_type=INTERNAL, the asset being queried is for accesses the partner has to your business assets.<br>
        If partner_type=EXTERNAL, the asset being queried is for the accesses you have to the partner's business asset.
      example: INTERNAL
      required: false
      schema:
        $ref: '#/components/schemas/PartnerType'
    query_targeting_types:
      name: targeting_types
      description: Targeting type breakdowns for the report. The reporting per targeting
        type <br> is independent from each other. ["AGE_BUCKET_AND_GENDER"] is in
        BETA and not yet available to all users.
      required: true
      explode: false
      in: query
      schema:
        items:
          $ref: '#/components/schemas/AdsAnalyticsTargetingType'
        maxItems: 15
        minItems: 1
        type: array
    query_term_limit:
      description: Max suggested terms to return.
      in: query
      name: limit
      example: 4
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 10
        default: 4
    query_timestamp:
      name: timestamp
      description: Timestamp
      in: query
      required: false
      schema:
        type: string
        example: '1618338184277'
        pattern: \d+
      style: form
    query_token_required:
      name: token
      description: Token returned from the post request creation call
      in: query
      required: true
      schema:
        type: string
    query_tos_type:
      description: Request type.
      explode: true
      in: query
      name: tos_type
      required: false
      schema:
        type: string
      style: form
    query_translate_interests_to_names:
      description: Return interests as text names (if value is true) rather than topic
        IDs.
      in: query
      name: translate_interests_to_names
      required: false
      schema:
        type: boolean
        default: false
    query_trending_keyword_limit:
      name: limit
      description: The maximum number of trending keywords that will be returned.
        Keywords are returned in trend-ranked order, so a `limit` of 50 will return
        the top 50 trends.
      example: 25
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 50
        default: 50
    query_user_following_feed_type:
      description: Thrift param specifying what type of followees will be kept. Default
        to include all followees.
      in: query
      name: feed_type
      required: false
      schema:
        type: string
        $ref: '#/components/schemas/UserFollowingFeedType'
        default: ALL
    query_username:
      name: username
      description: Name of the user to be looked up.
      in: query
      required: false
      schema:
        type: string
        pattern: (?!^\d+$)^.+$
        default: me
    query_video_pin_metric_types:
      description: 'Metric types to get video data for, default is all. '
      explode: false
      in: query
      name: metric_types
      required: false
      schema:
        items:
          enum:
          - IMPRESSION
          - SAVE
          - VIDEO_MRC_VIEW
          - VIDEO_AVG_WATCH_TIME
          - VIDEO_V50_WATCH_TIME
          - QUARTILE_95_PERCENT_VIEW
          - VIDEO_10S_VIEW
          - VIDEO_START
          - OUTBOUND_CLICK
          type: string
        type: array
      style: form
    query_video_pin_sort_by:
      description: Specify sorting order for video metrics
      explode: false
      in: query
      name: sort_by
      required: true
      schema:
        enum:
        - IMPRESSION
        - SAVE
        - OUTBOUND_CLICK
        - VIDEO_MRC_VIEW
        - VIDEO_AVG_WATCH_TIME
        - VIDEO_V50_WATCH_TIME
        - QUARTILE_95_PERCENT_VIEW
        - VIDEO_10S_VIEW
        - VIDEO_START
        type: string
    query_website:
      description: Website with path or domain only
      in: query
      name: website
      required: true
      schema:
        type: string
        example: mysite.test
    query_invite_status:
      name: invite_status
      in: query
      description: A list of invite statuses to filter invites by. Only invites whose
        status is in the provided statuses will be returned.
      required: false
      schema:
        type: array
        items:
          description: Invite statuses used for filters
          enum:
          - PENDING
          - EXPIRED
          example: PENDING
          type: string
        minItems: 1
        maxLength: 2
    query_invite_type:
      name: invite_type
      in: query
      description: Invite type to filter invites by. Only invites of the specified
        type will be returned.
      required: false
      schema:
        $ref: '#/components/schemas/InviteType'
    aggregate_report_rows:
      in: query
      description: Determines if report rows should be aggregated across all requested
        entities. This feature is currently in BETA and is not available to all users.
      name: aggregate_report_rows
      required: false
      schema:
        type: boolean
        default: false
    query_reporting_timezone:
      in: query
      description: Specify the timezone to be applied for the reporting. This feature
        is currently in BETA and is not available to all users.
      name: reporting_timezone
      required: false
      schema:
        $ref: '#/components/schemas/ReportingTimeZone'
    Pinterest.Lib.AdAccountId:
      name: ad_account_id
      in: path
      required: true
      description: Unique identifier of an ad account.
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    Pinterest.Lib.OrderingParams.order:
      name: order
      in: query
      required: false
      description: |-
        The order in which to sort the items returned: "ASCENDING" or "DESCENDING" by ID.
        Note that higher-value IDs are associated with more-recently added items.
      schema:
        default: ASCENDING
        type: string
        enum:
        - ASCENDING
        - DESCENDING
    Pinterest.Lib.BookmarkParams.page_size:
      name: page_size
      in: query
      required: false
      description: |-
        Maximum number of items to include in a single page.
        See documentation on [Pagination](/docs/reference/pagination/) for more information.
      schema:
        type: integer
        minimum: 1
        maximum: 250
        default: 25
    Pinterest.Lib.BookmarkParams.bookmark:
      name: bookmark
      in: query
      required: false
      description: Cursor used to fetch the next page of items
      schema:
        type: string
    SubscriptionIdPathParam:
      name: subscription_id
      in: path
      required: true
      description: Unique identifier of a subscription.
      schema:
        type: string
        pattern: ^\d+$
    QueryParams.query_pin_metrics:
      name: pin_metrics
      in: query
      required: false
      schema:
        type: boolean
        default: false
    QueryParams.query_include_protected_pins:
      name: include_protected_pins
      in: query
      required: false
      schema:
        type: boolean
        default: false
    QueryParams.query_pin_filter:
      name: pin_filter
      in: query
      required: false
      schema:
        type: string
        enum:
        - exclude_native
        - exclude_repins
        - has_been_promoted
    QueryParams.query_pin_type:
      name: pin_type
      in: query
      required: false
      schema:
        type: string
        enum:
        - PRIVATE
    QueryParams.query_ad_account_id:
      name: ad_account_id
      in: query
      required: false
      description: Unique identifier of an ad account.
      schema:
        type: string
        pattern: ^\d+$
        maxLength: 18
    QueryParams.query_creative_types:
      name: creative_types
      in: query
      required: false
      description: Pin creative types filter. **Note:** SHOP_THE_PIN has been deprecated.
        Please use COLLECTION instead.
      schema:
        type: array
        items:
          $ref: '#/components/schemas/CreativeType'
    PinKey:
      name: pin_id
      in: path
      required: true
      schema:
        type: string
        pattern: ^\d+$