{
  "openapi": "3.0.3",
  "info": {
    "version": "5.9.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.\n\n\nNote: If the current operation_user_account (defined by the access token)\nhas access to another user's Ad Accounts via\n<a href='/docs/reference/business-access/'>Pinterest Business Access</a>,\nyou can modify your request to use the current operation_user_account's\npermissions to those Ad Accounts by including the ad_account_id in the path\nparameters 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": "audience_insights",
      "description": "View audience insights."
    },
    {
      "name": "audiences",
      "description": "View, create, or update audiences."
    },
    {
      "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": "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": "integrations"
    },
    {
      "name": "interests",
      "description": "View interests."
    },
    {
      "name": "keywords",
      "description": "View, create or update keywords."
    },
    {
      "name": "lead_forms",
      "description": "View lead forms."
    },
    {
      "name": "media",
      "description": "Register and manage media uploads."
    },
    {
      "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": "product_groups",
      "description": "View, create, update, or delete information about product groups."
    },
    {
      "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": "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."
    }
  ],
  "paths": {
    "/oauth/token": {
      "post": {
        "summary": "Generate OAuth access token",
        "description": "Generate an OAuth access token by using an authorization code or a refresh token.\n\nIMPORTANT: You need to start the OAuth flow via www.pinterest.com/oauth before calling this endpoint (or have an existing refresh token).\n\nSee <a href='/docs/getting-started/authentication/'>Authentication</a> for more.",
        "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"
                }
              }
            }
          }
        }
      }
    },
    "/user_account": {
      "get": {
        "summary": "Get user account",
        "description": "Get account information for the \"operation user_account\"\n- By default, the \"operation user_account\" is the token user_account.\n\nIf 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/reference/business-access/'>Understanding Business Access</a> for more information.",
        "tags": [
          "user_account"
        ],
        "operationId": "user_account/get",
        "security": [
          {
            "pinterest_oauth2": [
              "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\"\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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_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).\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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"
            ]
          }
        ],
        "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_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).\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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"
            ]
          }
        ],
        "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_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/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"
            ]
          }
        ],
        "x-ratelimit-category": "org_read",
        "x-sandbox": "enabled",
        "parameters": [
          {
            "$ref": "#/components/parameters/query_bookmark"
          },
          {
            "$ref": "#/components/parameters/query_explicit_following"
          },
          {
            "$ref": "#/components/parameters/query_ad_account_id"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "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/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"
            ]
          }
        ],
        "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, or a specific user's followers.",
        "operationId": "followers/list",
        "security": [
          {
            "pinterest_oauth2": [
              "user_accounts:read"
            ]
          }
        ],
        "x-ratelimit-category": "ads_read",
        "x-sandbox": "enabled",
        "parameters": [
          {
            "$ref": "#/components/parameters/query_bookmark"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "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/{username}": {
      "post": {
        "summary": "Follow user",
        "description": "<strong>This endpoint is currently in beta and not available to all apps. <a href='/docs/new/about-beta-access/'>Learn more</a>.</strong>\n\nUse 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/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"
            ]
          }
        ],
        "x-ratelimit-category": "org_read",
        "x-sandbox": "disabled",
        "parameters": [
          {
            "$ref": "#/components/parameters/query_bookmark"
          },
          {
            "$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"
                    },
                    {
                      "properties": {
                        "items": {
                          "description": "Users",
                          "items": {
                            "$ref": "#/components/schemas/UserSummary"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "user_account"
        ]
      }
    },
    "/search/boards": {
      "get": {
        "summary": "Search user's boards",
        "description": "Search for boards for the \"operation user_account\". This includes boards of all board types.\n- By default, the \"operation user_account\" is the token user_account.\n\nIf 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/reference/business-access/'>Understanding Business Access</a> for more information.",
        "operationId": "search_user_boards/get",
        "security": [
          {
            "pinterest_oauth2": [
              "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_query"
          }
        ],
        "responses": {
          "200": {
            "description": "response",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "properties": {
                        "items": {
                          "description": "items",
                          "items": {
                            "$ref": "#/components/schemas/Board"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "search"
        ]
      }
    },
    "/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",
        "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"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "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",
        "security": [
          {
            "pinterest_oauth2": [
              "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"
      }
    },
    "/pins": {
      "get": {
        "summary": "List Pins",
        "description": "Get a list of the Pins owned by the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n- All Pins owned by the \"operation user_account\" are included, regardless of who owns the board they are on.\nOptional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".",
        "operationId": "pins/list",
        "security": [
          {
            "pinterest_oauth2": [
              "boards:read",
              "pins: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/pins' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "curl --location --request GET 'https://api-sandbox.pinterest.com/v5/pins' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/query_bookmark"
          },
          {
            "$ref": "#/components/parameters/query_pin_filter"
          },
          {
            "$ref": "#/components/parameters/query_include_protected_pins"
          },
          {
            "$ref": "#/components/parameters/query_pin_type"
          },
          {
            "$ref": "#/components/parameters/query_creative_types"
          },
          {
            "$ref": "#/components/parameters/query_ad_account_id"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Pin"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "description": "Invalid pin filter value",
            "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": [
          "pins"
        ]
      },
      "post": {
        "summary": "Create Pin",
        "description": "Create a Pin on a board or board section owned by the \"operation user_account\".\n\nNote: 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&...).\n\n- 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 <a href='/docs/add-ons/save-button'>Save button</a> instead. For more tips on creating fresh content for Pinterest, review our <a href='/docs/solutions/content-apps'>Content App Solutions Guide</a>.\n\n<strong><a href='/docs/solutions/content-apps/#creatingvideopins'>Learn more</a></strong> about video Pin creation.",
        "tags": [
          "pins"
        ],
        "operationId": "pins/create",
        "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\n\nfrom pinterest.organic.pins import Pin\n# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\nBOARD_ID=\"<Add your board id here>\"\n\npin_create = Pin.create(\n  board_id=BOARD_ID,\n  title=\"My Pin\",\n  description=\"Pin Description\",\n  media_source={\n      \"source_type\": \"image_url\",\n      \"content_type\": \"image/jpeg\",\n      \"data\": \"string\",\n      'url':'https://i.pinimg.com/564x/28/75/e9/2875e94f8055227e72d514b837adb271.jpg'\n      }\n  )\nprint(\"Pin Id: %s, Pin Title:%s\" %(pin_create.id, pin_create.title))\n"
          },
          {
            "lang": "cURL",
            "label": "curl",
            "source": "# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --location --request POST 'https://api.pinterest.com/v5/pins' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n      \"title\": \"My Pin\",\n      \"description\": \"Pin Description\",\n      \"board_id\": \"<insert_your_board_id>,\n      \"media_source\": {\n        \"source_type\": \"image_url\",\n        \"url\": \"https://i.pinimg.com/564x/28/75/e9/2875e94f8055227e72d514b837adb271.jpg\"\n      }\n  }'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --location --request POST 'https://api-sandbox.pinterest.com/v5/boards' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n      \"title\": \"My Pin\",\n      \"description\": \"Pin Description\",\n      \"board_id\": \"<insert_your_sandbox_board_id>,\n      \"media_source\": {\n        \"source_type\": \"image_url\",\n        \"url\": \"https://i.pinimg.com/564x/28/75/e9/2875e94f8055227e72d514b837adb271.jpg\"\n      }\n  }'\n"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/query_ad_account_id"
          }
        ],
        "requestBody": {
          "description": "Create a new Pin.",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PinCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful pin creation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Pin"
                }
              }
            }
          },
          "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."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "The Pin's image is too small, too large or is broken",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "PinImageTooSmall": {
                    "value": {
                      "code": 233,
                      "message": "Your image is too small. Please choose a larger image and try again."
                    }
                  },
                  "PinImageBroken": {
                    "value": {
                      "code": 235,
                      "message": "Sorry, this image is broken. Please pick a different image."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Board or section not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "BoardNotFound": {
                    "value": {
                      "code": 40,
                      "message": "Board not found."
                    }
                  },
                  "BoardSectionNotFound": {
                    "value": {
                      "code": 2031,
                      "message": "Sorry! We couldn't find this board section."
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "This request exceeded a rate limit. This can happen if the client exceeds one\nof the published rate limits or if multiple write operations are applied to\nan 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\nof the published rate limits or if multiple write operations are applied to\nan object within a short time window."
                }
              }
            }
          },
          "default": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/pins/{pin_id}": {
      "get": {
        "summary": "Get Pin",
        "description": "Get a Pin owned by the \"operation user_account\" - or on a group board that has been shared with this account.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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:\n\n- For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.\n- For Pins on secret boards: Owner, Admin.",
        "tags": [
          "pins"
        ],
        "operationId": "pins/get",
        "security": [
          {
            "pinterest_oauth2": [
              "boards:read",
              "pins: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\n\nfrom pinterest.organic.pins import Pin\n# Pin information can be fetched from profile page or from list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\nPIN_ID=\"<Add your pin id here>\"\n\npin_get = Pin(pin_id=PIN_ID)\nprint(\"Pin Id: %s, Pin Title:%s\" %(pin_get.id, pin_get.title))\n"
          },
          {
            "lang": "cURL",
            "label": "curl",
            "source": "# Pin information can be fetched from profile page or from list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\n\ncurl --location --request GET 'https://api.pinterest.com/v5/pins/<insert_pin_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "# Pin information can be fetched from profile page or from list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\n\ncurl --location --request GET 'https://api-sandbox.pinterest.com/v5/pins/<insert_sandbox_pin_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/path_pin_id"
          },
          {
            "$ref": "#/components/parameters/query_ad_account_id"
          }
        ],
        "responses": {
          "200": {
            "description": "response",
            "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": "Pin not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "code": 50,
                  "message": "Pin not found."
                }
              }
            }
          },
          "default": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Delete Pin",
        "description": "Delete a Pins owned by the \"operation user_account\" - or on a group board that has been shared with this account.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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:\n\n- For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.\n- For Pins on secret boards: Owner, Admin.",
        "tags": [
          "pins"
        ],
        "operationId": "pins/delete",
        "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\n\nfrom pinterest.organic.pins import Pin\n# Pin information can be fetched from profile page or from create/list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\nPIN_ID=\"<Add your pin id here>\"\n\npin_delete=Pin.delete(pin_id=PIN_ID)\n\nprint(\"Pin was deleted? %s\" % (pin_delete))\n"
          },
          {
            "lang": "cURL",
            "label": "curl",
            "source": "# Pin information can be fetched from profile page or from create/list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\n\ncurl --request DELETE 'https://api.pinterest.com/v5/pins/<insert_pin_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "# Pin information can be fetched from profile page or from create/list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\n\ncurl --request DELETE 'https://api-sandbox.pinterest.com/v5/pins/<insert_sandbox_pin_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/path_pin_id"
          },
          {
            "$ref": "#/components/parameters/query_ad_account_id"
          }
        ],
        "responses": {
          "204": {
            "description": "Successfully deleted Pin"
          },
          "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"
                }
              }
            }
          }
        }
      },
      "patch": {
        "summary": "Update Pin",
        "description": "Update a pin owned by the \"operating user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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:\n\n- For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.\n- For Pins on secret boards: Owner, Admin.\n\n<strong>This endpoint is currently in beta and not available to all apps. <a href='/docs/new/about-beta-access/'>Learn more</a>.</strong>",
        "tags": [
          "pins"
        ],
        "operationId": "pins/update",
        "security": [
          {
            "pinterest_oauth2": [
              "boards:read",
              "boards:write",
              "pins:read",
              "pins:write"
            ]
          }
        ],
        "x-ratelimit-category": "org_write",
        "x-sandbox": "enabled",
        "x-codeSamples": [
          {
            "lang": "cURL",
            "label": "curl",
            "source": "# Pin information can be fetched from profile page or from create/list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\n\ncurl --location --request PATCH 'https://api.pinterest.com/v5/pins/<insert_pin_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n  \"title\": \"My updated Pin title\"\n}'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "# Pin information can be fetched from profile page or from create/list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\n\ncurl --location --request GET 'https://api-sandbox.pinterest.com/v5/pins/<insert_sandbox_pin_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n  \"title\": \"My updated Pin title\"\n}'\n"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/path_pin_id"
          },
          {
            "$ref": "#/components/parameters/query_ad_account_id"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PinUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Pin"
                }
              }
            }
          },
          "403": {
            "description": "Not authorized to update Pin.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "code": 29,
                  "message": "Not authorized to update 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\nof the published rate limits or if multiple write operations are applied to\nan 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\nof the published rate limits or if multiple write operations are applied to\nan 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\".\n- By default, the \"operation user_account\" is the token user_account.\nOptional: 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:\n\n- For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.\n- For Pins on secret boards: Owner, Admin.\n\n- Any Pin type can be saved: image Pin, video Pin, Idea Pin, product Pin, etc.\n- 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\n\nfrom pinterest.organic.pins import Pin\n# Pin information can be fetched from profile page or from create/list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\nPIN_ID=\"<Add your pin id here>\"\n\n# Board information can be fetched from profile page or from list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\nNEW_BOARD_ID=\"<Add your board id here>\"\n\npin_save = Pin(pin_id=PIN_ID)\npin_save.save(board_id=NEW_BOARD_ID)\nprint(\"Pin Id: %s, Board Id:%s\" %(pin_save.id, pin_save.board_id))\n"
          },
          {
            "lang": "cURL",
            "label": "curl",
            "source": "# Pin and Board information can be fetched from profile page or from create/list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --request DELETE 'https://api.pinterest.com/v5/pins/<insert_pin_id>/save' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"board_id\": <insert_new_board_id>\n}'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "# Pin and Board information can be fetched from profile page or from create/list pin method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/pins/list\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --request DELETE 'https://api-sandbox.pinterest.com/v5/pins/<insert_sandbox_pin_id>/save' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"board_id\": <insert_new_sandbox_board_id>\n}'\n"
          }
        ],
        "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+$"
                  },
                  "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"
                }
              }
            }
          }
        }
      }
    },
    "/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.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href=\"https://developers.pinterest.com/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:\n\n- For Pins on public or protected boards: Admin, Analyst.\n- For Pins on secret boards: Admin.",
        "tags": [
          "pins"
        ],
        "operationId": "pins/analytics",
        "security": [
          {
            "pinterest_oauth2": [
              "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/AnalyticsResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/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\nOptional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\nOptional: Specify a privacy type (public, protected, or secret) to indicate which boards to return.\n- 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"
            ]
          }
        ],
        "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' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "curl --location --request GET 'https://api-sandbox.pinterest.com/v5/boards' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          }
        ],
        "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": [
                "PUBLIC",
                "PROTECTED",
                "SECRET"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "response",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "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\".\nOptional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.",
        "tags": [
          "boards"
        ],
        "operationId": "boards/create",
        "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\n\nfrom pinterest.organic.boards import Board\n\nboard_create=Board.create(\n  name=\"Summer Recipes\",\n  description=\"My favorite summer recipes\",\n  privacy=\"PUBLIC\"\n)\nprint(\"Board Id: %s, Board name:%s\"%(board_create.id, board_create.name))\n"
          },
          {
            "lang": "cURL",
            "label": "curl",
            "source": "curl --location --request POST 'https://api.pinterest.com/v5/boards' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n      \"name\": \"Summer Recipes\",\n      \"description\": \"My favorite summer recipes\",\n      \"privacy\": \"PUBLIC\"\n}'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "curl --location --request POST 'https://api-sandbox.pinterest.com/v5/boards' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n      \"name\": \"Summer Recipes\",\n      \"description\": \"My favorite summer recipes\",\n      \"privacy\": \"PUBLIC\"\n}'\n"
          }
        ],
        "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.\n- Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.",
        "tags": [
          "boards"
        ],
        "operationId": "boards/get",
        "security": [
          {
            "pinterest_oauth2": [
              "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\n\nfrom pinterest.organic.boards import Board\n# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\nBOARD_ID=\"<Add your board id here>\"\n\nboard_get = Board(board_id=BOARD_ID)\nprint(\"Board Id: %s, Board name:%s\"%(board_get.id, board_get.name))\n"
          },
          {
            "lang": "cURL",
            "label": "curl",
            "source": "# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --location --request GET 'https://api.pinterest.com/v5/boards/<insert_your_board_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "# Board information can be fetched from profile page or from create/ist board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --location --request GET 'https://api-sandbox.pinterest.com/v5/boards/<insert_your_board_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json'\n"
          }
        ],
        "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\".\n- Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.",
        "tags": [
          "boards"
        ],
        "operationId": "boards/update",
        "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\n\nfrom pinterest.organic.boards import Board\n# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\nBOARD_ID=\"<Add your board id here>\"\nNEW_DESCRIPTION=\"Updated summer recipes!\"\nNEW_PRIVACY=\"SECRET\"\n\nboard_update = Board(board_id=BOARD_ID)\nboard_update.update_fields(\n    description=NEW_DESCRIPTION,\n    privacy=NEW_PRIVACY\n)\nprint(\"Board Id: %s, Board description:%s, Board privacy:%s\" %(board_update.id, board_update.description, board_update.privacy))\n"
          },
          {
            "lang": "cURL",
            "label": "curl",
            "source": "# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --location --request PATCH 'https://api.pinterest.com/v5/boards/<insert_board_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n      \"name\": \"New Summer Recipes\",\n      \"description\": \"Updated summer recipes!\",\n      \"privacy\": \"SECRET\"\n}'\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --location --request PATCH 'https://api-sandbox.pinterest.com/v5/boards/<insert_board_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n      \"name\": \"New Summer Recipes\",\n      \"description\": \"Updated summer recipes!\",\n      \"privacy\": \"SECRET\"\n}'\n"
          }
        ],
        "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\nof the published rate limits or if multiple write operations are applied to\nan 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\nof the published rate limits or if multiple write operations are applied to\nan 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\".\n- Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- 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\n\nfrom pinterest.organic.boards import Board\n# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\nBOARD_ID=\"<Add your board id here>\"\n\nboard_delete=Board.delete(board_id=BOARD_ID)\nprint(\"Board was deleted? %s\" % (board_delete))\n"
          },
          {
            "lang": "cURL",
            "label": "curl",
            "source": "# Board information can be fetched from profile page or create/from list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --request DELETE 'https://api.pinterest.com/v5/boards/<insert_board_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n"
          },
          {
            "lang": "cURL",
            "label": "curl (Sandbox)",
            "source": "# Board information can be fetched from profile page or from create/list board method here:\n# https://developers.pinterest.com/docs/api/v5/#operation/boards/list\n\ncurl --request DELETE 'https://api-sandbox.pinterest.com/v5/boards/<insert_board_id>' \\\n--header 'Authorization: Bearer <Add your token here>' \\\n--header 'Content-Type: application/json' \\\n"
          }
        ],
        "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\nof the published rate limits or if multiple write operations are applied to\nan 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\nof the published rate limits or if multiple write operations are applied to\nan object within a short time window."
                }
              }
            }
          },
          "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.\nOptional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.",
        "tags": [
          "boards"
        ],
        "operationId": "board_sections/list",
        "security": [
          {
            "pinterest_oauth2": [
              "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"
                    },
                    {
                      "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.\nOptional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- 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.\nOptional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- 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.\nOptional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- 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.\nOptional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- 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"
            ]
          }
        ],
        "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"
                    },
                    {
                      "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"
                }
              }
            }
          }
        }
      }
    },
    "/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.\n- Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.",
        "tags": [
          "boards"
        ],
        "operationId": "boards/list_pins",
        "security": [
          {
            "pinterest_oauth2": [
              "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"
          }
        ],
        "responses": {
          "200": {
            "description": "response",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "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"
                }
              }
            }
          }
        }
      }
    },
    "/media": {
      "get": {
        "summary": "List media uploads",
        "description": "List media uploads filtered by given parameters.\n\n<strong><a href='/docs/solutions/content-apps/#creatingvideopins'>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"
                    },
                    {
                      "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\n\nThe response includes all of the information needed to upload the media\nto Pinterest.\n\nTo upload the media, make an HTTP POST request (using <tt>curl</tt>, for\nexample) to <tt>upload_url</tt> using the <tt>Content-Type</tt> header\nvalue. Send the media file's contents as the request's <tt>file</tt>\nparameter and also include all of the parameters from\n<tt>upload_parameters</tt>.\n\n<strong><a href='/docs/solutions/content-apps/#creatingvideopins'>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.\n\n<strong><a href='/docs/solutions/content-apps/#creatingvideopins'>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"
                }
              }
            }
          }
        }
      }
    },
    "/ad_accounts": {
      "get": {
        "summary": "List ad accounts",
        "description": "Get a list of the ad_accounts that the \"operation user_account\" has access to.\n- 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"
            ]
          }
        ],
        "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"
                    },
                    {
                      "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.\nAn 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/>\nYou can set up up to 50 ad accounts per user. (The user must have a business account to create an ad account.) <p/>\nFor 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"
            ]
          }
        ],
        "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}/analytics": {
      "get": {
        "summary": "Get ad account analytics",
        "description": "Get analytics for the specified <code>ad_account_id</code>, filtered by the specified options.\n- 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.\n- 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.\n- If granularity is HOUR, the furthest back you can are allowed to pull data is 8 days before the current date in UTC time.",
        "operationId": "ad_account/analytics",
        "security": [
          {
            "pinterest_oauth2": [
              "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"
          }
        ],
        "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}/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,\nthe response will include the requested metric information (e.g. SPEND_IN_DOLLAR) for the requested target type\n(e.g. \"age_bucket\") for applicable values (e.g. \"45-49\"). <p/>\n- The token's user_account must either be the Owner of the specified ad account, or have one\nof the necessary roles granted to them via\n<a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a>: Admin, Analyst, Campaign Manager.\n- 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.\n- 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.",
        "operationId": "ad_targeting_analytics/get",
        "security": [
          {
            "pinterest_oauth2": [
              "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_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"
          }
        ],
        "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}/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.\n- 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"
            ]
          }
        ],
        "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"
                    },
                    {
                      "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’s profile.</p>\n<p>A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser’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/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",
                "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’s profile.</p>\n<p>A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser’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",
                "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/{campaign_id}": {
      "get": {
        "summary": "Get campaign",
        "description": "Get a specific campaign given the campaign ID.",
        "operationId": "campaigns/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_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}/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.\n- 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.\n- 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.\n- 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.",
        "operationId": "campaigns/analytics",
        "security": [
          {
            "pinterest_oauth2": [
              "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"
          }
        ],
        "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.\nFor the requested account and metrics, the response will include the requested metric information\n(e.g. SPEND_IN_DOLLAR) for the requested target type (e.g. \"age_bucket\") for applicable values (e.g. \"45-49\"). <p/>\n- The token's user_account must either be the Owner of the specified ad account, or have one\nof the necessary roles granted to them via\n<a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a>: Admin, Analyst, Campaign Manager.\n- 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.\n- 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.",
        "operationId": "campaign_targeting_analytics/get",
        "security": [
          {
            "pinterest_oauth2": [
              "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_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"
          }
        ],
        "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}/ad_groups/targeting_analytics": {
      "get": {
        "summary": "Get targeting analytics for ad groups",
        "description": "Get targeting analytics for one or more ad groups.\nFor the requested ad group(s) and metrics, the response will include the requested metric information\n(e.g. SPEND_IN_DOLLAR) for the requested target type (e.g. \"age_bucket\") for applicable values (e.g. \"45-49\"). <p/>\n- The token's user_account must either be the Owner of the specified ad account, or have one\nof the necessary roles granted to them via\n<a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a>: Admin, Analyst, Campaign Manager.\n- 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.\n- 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.",
        "operationId": "ad_groups_targeting_analytics/get",
        "security": [
          {
            "pinterest_oauth2": [
              "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_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"
          }
        ],
        "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": {
      "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/>\n<strong>Note:</strong><p/>\nProvide only campaign_id or ad_group_id. Do not provide both.",
        "operationId": "ad_groups/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_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"
                    },
                    {
                      "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>.</p>\n<strong>Note:</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’s profile.</p>\n<p>A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser’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>\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- Start and end time cannot be set for ad groups that belong to CBO campaigns. Currently, campaigns with the following objective types: TRAFFIC, AWARENESS, WEB_CONVERSIONS, and CATALOG_SALES will default to CBO.",
        "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/{ad_group_id}": {
      "get": {
        "summary": "Get ad group",
        "description": "Get a specific ad given the ad ID. If your pin is rejected, rejected_reasons will\ncontain additional information from the Ad Review process.\nFor more information about our policies and rejection reasons see the <a href=\"https://www.pinterest.com/_/_/policy/advertising-guidelines/\"\ntarget=\"_blank\">Pinterest advertising standards</a>.",
        "operationId": "ad_groups/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_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_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.\n- 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.\n- 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.\n- 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.",
        "operationId": "ad_groups/analytics",
        "security": [
          {
            "pinterest_oauth2": [
              "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"
          }
        ],
        "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}/ads": {
      "get": {
        "summary": "List ads",
        "description": "List ads that meet the filters provided:\n  - Listed campaign ids or ad group ids or ad ids\n  - Listed entity statuses <p/>\nIf no filter is provided, all ads in the ad account are returned. <p/>\n<strong>Note:</strong><p/>\nProvide only campaign_id or ad_group_id or ad_id. Do not provide more than one type. <p/>\nReview status is provided for each ad; if review_status is REJECTED, the rejected_reasons field will contain additional information.\nFor more, see <a href=\"https://policy.pinterest.com/en/advertising-guidelines\">Pinterest advertising standards</a>.",
        "operationId": "ads/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_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"
                    },
                    {
                      "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/{ad_id}": {
      "get": {
        "summary": "Get ad",
        "description": "Get a specific ad given the ad ID. If your pin is rejected, rejected_reasons will\ncontain additional information from the Ad Review process.\nFor more information about our policies and rejection reasons see the <a href=\"https://www.pinterest.com/_/_/policy/advertising-guidelines/\"\ntarget=\"_blank\">Pinterest advertising standards</a>.",
        "operationId": "ads/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_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}/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.\n- 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.\n- 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.\n- 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.",
        "operationId": "ads/analytics",
        "security": [
          {
            "pinterest_oauth2": [
              "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_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"
          }
        ],
        "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}/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/>\nIf 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/>\nYou can view the returned preview URL on a webpage or iframe for 7 days, after which the URL expires.",
        "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}/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’s profile.</p>\n<p>A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser’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"
            ]
          }
        ],
        "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}/events": {
      "post": {
        "summary": "Send conversion events to the Pinterest API for 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.\n- This endpoint requires an <code>access_token</code> be generated through Ads Manager. Review the <a href=\"/docs/conversions/conversions/\">Conversions Guide</a> for more details.\n- 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.)\n- This endpoint has a rate limit of 5,000 calls per minute per ad account.\n- 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.\nWarning: 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."
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "This request exceeded a rate limit. This can happen if the client exceeds one\nof 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\nof 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}/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.\n- 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.\n- 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.\n- 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.",
        "operationId": "product_groups/analytics",
        "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_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"
          }
        ],
        "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}/product_groups/catalogs": {
      "get": {
        "description": "Get a list of catalog product groups used by the feed profile ID.",
        "operationId": "ad_accounts_catalogs_product_groups/list",
        "security": [
          {
            "pinterest_oauth2": [
              "ads:write"
            ]
          }
        ],
        "x-ratelimit-category": "ads_write",
        "x-sandbox": "disabled",
        "parameters": [
          {
            "$ref": "#/components/parameters/path_ad_account_id"
          },
          {
            "$ref": "#/components/parameters/query_feed_profile_id"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/CatalogProductGroup"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            },
            "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."
                }
              }
            }
          },
          "401": {
            "description": "Access Denied. This can happen if account is not yet approved to operate as Merchant on Pinterest.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Merchant data not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Unexpected error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "summary": "Get catalog product groups",
        "tags": [
          "product_groups"
        ]
      }
    },
    "/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 and it's valid for an hour.\n- 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.\n- 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.\n- If granularity is not HOUR, the furthest back you can are allowed to pull data is 914 days before the current date in UTC time and the max time range supported is 186 days.\n- 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.\n- If level is PRODUCT_ITEM, the furthest back you can are allowed to pull data is 92 days before the current date in UTC time and the max time range supported is 31 days.",
        "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}/audiences": {
      "get": {
        "summary": "List audiences",
        "description": "Get list of audiences for the ad account.",
        "operationId": "audiences/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_bookmark"
          },
          {
            "$ref": "#/components/parameters/query_order"
          },
          {
            "$ref": "#/components/parameters/query_page_size"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "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\nthe ways users interact with Pinterest to help you reach specific groups of users; you can include or exclude\nspecific audience_ids when you create an ad group. <p/>\nFor 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"
            ]
          }
        ],
        "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}/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\nad account's engaged audience on Pinterest, the ad account's total audience on Pinterest and Pinterest's\ntotal audience.<p/>\n<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"
            ]
          }
        ],
        "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}/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"
            ]
          }
        ],
        "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}/insights/audiences/{scope}/{type}/{category_id}": {
      "get": {
        "deprecated": true,
        "description": "Get information about a category's sub-level interests. For a list of interests, their IDs, and hierarchy,\nsee the [list of interests](https://docs.google.com/spreadsheets/d/1HxL-0Z3p2fgxis9YBP2HWC3tvPrs1hAuHDRtH-NJTIM/edit#gid=118370875).\nAlso, a category is a level-one (L1) interest. For example, in the interest hierarchy see **Animals** > **Mammals** > **Dogs**, **Animals**\nis the category.\n\nThis endpoint has been deprecated.",
        "operationId": "audiences_insights/category/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/path_scope"
          },
          {
            "$ref": "#/components/parameters/path_type"
          },
          {
            "$ref": "#/components/parameters/path_category_id"
          },
          {
            "$ref": "#/components/parameters/query_sort"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AudienceInsightCategoryArrayResponse"
                }
              }
            },
            "description": "Success"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "Unexpected error"
          }
        },
        "summary": "Get category sub-interest (DEPRECATED)",
        "tags": [
          "audience_insights"
        ]
      }
    },
    "/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/ads/targeting/#Audiences\" 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 – containing only the Pinterest accounts that were included in your starting\nlist – 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 “CUSTOMER_LIST” 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>\n<p>(Customer lists are a type of audience.) For more information, see\n<a href=\"https://help.pinterest.com/en/business/article/audience-targeting\" target=\"_blank\">Audience targeting</a>\n or the <a href=\"/docs/ads/targeting/#Audiences\" target=\"_blank\">Audiences</a>\nsection 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"
                    },
                    {
                      "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"
            ]
          }
        ],
        "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 “CUSTOMER_LIST” audience. Your original list of records\nto 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/ads/targeting/#Audiences\" 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}/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>\n<p>For more information, see <a target=\"_blank\" href=\"https://help.pinterest.com/en/business/article/keyword-targeting\">Keyword targeting</a>.</p>\n<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 href=\"/docs/redoc/#section/Match-type-(keyword)\">match type enums</a>.</p>\n<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"
            ]
          }
        ],
        "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"
          },
          {
            "$ref": "#/components/parameters/query_page_size"
          },
          {
            "$ref": "#/components/parameters/query_bookmark"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "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>\n<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 href=\"/docs/redoc/#section/Match-type-(keyword)\">match type enums</a>.</p>\n<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>\n<p><b>Rate limit</b>: <a href=\"/docs/redoc/#tag/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.\n(Definitions are available from the \"Get delivery metrics definitions\"\n<a href=\"/docs/api/v5/#operation/delivery_metrics/get\">API endpoint</a>).",
        "operationId": "country_keywords_metrics/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/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}/lead_forms": {
      "get": {
        "summary": "Get lead forms",
        "description": "Gets all Lead Forms associated with an ad account ID.\nThis endpoint is in beta and not available to all advertisers. <a href='/docs/new/about-beta-access/'>Learn more</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"
                    },
                    {
                      "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"
        ]
      }
    },
    "/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.\n\nInclude either ad_group_id or product_group_promotion_ids in your request.\n\n<b>Note:</b> ad_group_ids and product_group_promotion_ids are mutually exclusive parameters.\nOnly 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"
                    },
                    {
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ProductGroupPromotionResponseItem"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            },
            "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/ProductGroupPromotionResponse"
                }
              }
            },
            "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}/targeting_analytics": {
      "get": {
        "summary": "Get targeting analytics for an ad account",
        "description": "Get targeting analytics for an ad account.\nFor the requested account and metrics, the response will include the requested metric information\n(e.g. SPEND_IN_DOLLAR) for the requested target type (e.g. \"age_bucket\") for applicable values (e.g. \"45-49\"). <p/>\n- The token's user_account must either be the Owner of the specified ad account, or have one\nof the necessary roles granted to them via\n<a href=\"https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts\">Business Access</a>: Admin, Analyst, Campaign Manager.\n- 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.\n- 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.",
        "operationId": "ad_account_targeting_analytics/get",
        "security": [
          {
            "pinterest_oauth2": [
              "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"
          }
        ],
        "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}/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"
                    },
                    {
                      "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\ntemplate. 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"
        ]
      }
    },
    "/terms/suggested": {
      "get": {
        "summary": "List suggested terms",
        "description": "Get popular search terms that begin with your input term. <p/>\nExample: '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"
                }
              }
            }
          }
        }
      }
    },
    "/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"
        ]
      }
    },
    "/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,\nand/or keywords; can filter by campaigns. Though the entities may be active, archived, or paused,\nonly 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, or keywords.\nNote that this request will be processed asynchronously; the response will include a <code>request_id</code>\nthat 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\nnew or updated entity data (campaigns, ad groups, product groups, ads, or keywords).",
        "operationId": "bulk_request/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_bulk_request_id"
          }
        ],
        "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"
        ]
      }
    },
    "/catalogs/feeds": {
      "get": {
        "x-ratelimit-category": "catalogs_read",
        "summary": "List feeds",
        "description": "Fetch feeds owned by the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "feeds/list",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "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"
                    },
                    {
                      "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": [
          "catalogs"
        ]
      },
      "post": {
        "x-ratelimit-category": "catalogs_write",
        "summary": "Create feed",
        "description": "Create a new feed owned by the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nPlease, be aware that \"default_country\"\nand \"default_locale\" are not required in the spec for forward compatibility\nbut for now the API will not accept requests without those fields.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "feeds/create",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read",
              "catalogs:write"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "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/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. Account is disapproved."
                    }
                  }
                }
              }
            }
          },
          "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": [
          "catalogs"
        ]
      }
    },
    "/catalogs/feeds/{feed_id}": {
      "get": {
        "x-ratelimit-category": "catalogs_read",
        "summary": "Get feed",
        "description": "Get a single feed owned by the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "feeds/get",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "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": [
          "catalogs"
        ]
      },
      "patch": {
        "x-ratelimit-category": "catalogs_write",
        "summary": "Update feed",
        "description": "Update a feed owned by the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "feeds/update",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read",
              "catalogs:write"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "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": {
                "$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. Account is disapproved."
                    }
                  },
                  "MerchantUnderReview": {
                    "value": {
                      "code": 2626,
                      "message": "Sorry, you cannot perform this action. Account is under review."
                    }
                  }
                }
              }
            }
          },
          "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": [
          "catalogs"
        ]
      },
      "delete": {
        "x-ratelimit-category": "catalogs_write",
        "summary": "Delete feed",
        "description": "Delete a feed owned by the \"operating user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "feeds/delete",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read",
              "catalogs:write"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "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. Account is disapproved."
                    }
                  },
                  "MerchantUnderReview": {
                    "value": {
                      "code": 2626,
                      "message": "Sorry, you cannot perform this action. Account is under review."
                    }
                  }
                }
              }
            }
          },
          "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": [
          "catalogs"
        ]
      }
    },
    "/catalogs/feeds/{feed_id}/processing_results": {
      "get": {
        "x-ratelimit-category": "catalogs_read",
        "summary": "List processing results for a given feed",
        "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.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "feed_processing_results/list",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "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"
                    },
                    {
                      "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": [
          "catalogs"
        ]
      }
    },
    "/catalogs/processing_results/{processing_result_id}/item_issues": {
      "get": {
        "x-ratelimit-category": "catalogs_read",
        "summary": "List item issues for a given processing result",
        "description": "List item validation issues for a given feed processing result owned by the \"operation user_account\". 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.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "items_issues/list",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "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"
                    },
                    {
                      "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": [
          "catalogs"
        ]
      }
    },
    "/catalogs/items": {
      "get": {
        "summary": "Get catalogs items",
        "description": "Get the items of the catalog owned by the \"operation user_account\". <a href=\"/docs/shopping/catalog/#Update%20items%20in%20batch\" target=\"_blank\">See detailed documentation here.</a>\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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/get",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read"
            ]
          }
        ],
        "x-ratelimit-category": "catalogs_read",
        "x-sandbox": "disabled",
        "parameters": [
          {
            "$ref": "#/components/parameters/query_catalogs_items_country"
          },
          {
            "$ref": "#/components/parameters/query_catalogs_items"
          },
          {
            "$ref": "#/components/parameters/query_catalogs_items_language"
          },
          {
            "$ref": "#/components/parameters/query_ad_account_id"
          }
        ],
        "responses": {
          "200": {
            "description": "Response containing the requested catalogs items",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogsItems"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "InvalidRequest": {
                    "value": {
                      "code": 1,
                      "message": "Parameter 'item_ids' is required."
                    }
                  }
                }
              }
            }
          },
          "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": [
          "catalogs"
        ]
      }
    },
    "/catalogs/items/batch/{batch_id}": {
      "get": {
        "summary": "Get catalogs items batch",
        "description": "Get a single catalogs items batch owned by the \"operating user_account\". <a href=\"/docs/shopping/catalog/#Update%20items%20in%20batch\" target=\"_blank\">See detailed documentation here.</a>\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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"
            ]
          }
        ],
        "x-ratelimit-category": "catalogs_read",
        "x-sandbox": "disabled",
        "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": [
          "catalogs"
        ]
      }
    },
    "/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/shopping/catalog/#Update%20items%20in%20batch\" target=\"_blank\">See detailed documentation here.</a>\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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/post",
        "x-ratelimit-category": "catalogs_write",
        "x-sandbox": "disabled",
        "security": [
          {
            "pinterest_oauth2": [
              "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": {
                "$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": [
          "catalogs"
        ]
      }
    },
    "/catalogs/products/get_by_product_group_filters": {
      "post": {
        "x-ratelimit-category": "catalogs_read",
        "summary": "List filtered products",
        "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.\n- This endpoint has been implemented in POST to allow for complex filters. This specific POST endpoint is designed to be idempotent.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "products_by_product_group_filter/list",
        "security": [
          {
            "pinterest_oauth2": [
              "boards:read",
              "catalogs:read",
              "pins:read"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "parameters": [
          {
            "$ref": "#/components/parameters/query_bookmark"
          },
          {
            "$ref": "#/components/parameters/query_page_size"
          },
          {
            "$ref": "#/components/parameters/query_ad_account_id"
          }
        ],
        "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"
                    },
                    {
                      "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": [
          "catalogs"
        ]
      }
    },
    "/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\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "catalogs_product_groups/get",
        "x-sandbox": "disabled",
        "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/CatalogsProductGroup"
                }
              }
            },
            "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. Account is disapproved."
                    }
                  },
                  "MerchantUnderReview": {
                    "value": {
                      "code": 2626,
                      "message": "Sorry, you cannot perform this action. Account is under review."
                    }
                  }
                }
              }
            }
          },
          "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": [
          "catalogs"
        ]
      },
      "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.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "catalogs_product_groups/delete",
        "x-sandbox": "disabled",
        "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. Account is disapproved."
                    }
                  },
                  "MerchantUnderReview": {
                    "value": {
                      "code": 2626,
                      "message": "Sorry, you cannot perform this action. Account is under review."
                    }
                  }
                }
              }
            }
          },
          "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": [
          "catalogs"
        ]
      },
      "patch": {
        "x-ratelimit-category": "catalogs_write",
        "summary": "Update product group",
        "description": "Update product group owned by the \"operation user_account\" to use in Catalogs.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "catalogs_product_groups/update",
        "x-sandbox": "disabled",
        "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": {
                "$ref": "#/components/schemas/CatalogsProductGroupUpdateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogsProductGroup"
                }
              }
            },
            "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."
                    }
                  }
                }
              }
            }
          },
          "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. Account is disapproved."
                    }
                  },
                  "MerchantUnderReview": {
                    "value": {
                      "code": 2626,
                      "message": "Sorry, you cannot perform this action. Account is under review."
                    }
                  }
                }
              }
            }
          },
          "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": [
          "catalogs"
        ]
      }
    },
    "/catalogs/product_groups/{product_group_id}/products": {
      "get": {
        "x-ratelimit-category": "catalogs_read",
        "summary": "List products",
        "description": "Get a list of product pins for a given Catalogs Product Group Id owned by the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "catalogs_product_group_pins/list",
        "security": [
          {
            "pinterest_oauth2": [
              "boards:read",
              "catalogs:read",
              "pins:read"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "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"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Paginated"
                    },
                    {
                      "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": [
          "catalogs"
        ]
      }
    },
    "/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\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "catalogs_product_groups/product_counts_get",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "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/CatalogsProductGroupProductCounts"
                }
              }
            },
            "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": [
          "catalogs"
        ]
      }
    },
    "/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\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "catalogs_product_groups/list",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:read"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "parameters": [
          {
            "$ref": "#/components/parameters/query_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"
                    },
                    {
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/CatalogsProductGroup"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            },
            "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. Account is disapproved."
                    }
                  },
                  "MerchantUnderReview": {
                    "value": {
                      "code": 2626,
                      "message": "Sorry, you cannot perform this action. Account is under review."
                    }
                  }
                }
              }
            }
          },
          "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": [
          "catalogs"
        ]
      },
      "post": {
        "x-ratelimit-category": "catalogs_write",
        "summary": "Create product group",
        "description": "Create product group to use in Catalogs owned by the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: 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.\n\n<a href='/docs/shopping/catalog/'>Learn more</a>",
        "operationId": "catalogs_product_groups/create",
        "security": [
          {
            "pinterest_oauth2": [
              "catalogs:write"
            ]
          }
        ],
        "x-sandbox": "disabled",
        "parameters": [
          {
            "$ref": "#/components/parameters/query_ad_account_id"
          }
        ],
        "requestBody": {
          "description": "Request object used to created a catalogs product group.",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CatalogsProductGroupCreateRequest"
              },
              "examples": {
                "FewFiltersUsingAllOf": {
                  "summary": "An simple example that applies \"all of the following filters\".",
                  "description": "The use of \"all_of\" creates a Product Group where all of the individual filters\nmust be satisfied by a product to be included in the Product Group.\n",
                  "value": {
                    "name": "Few Filters using \"all_of\"",
                    "feed_id": "2680059592705",
                    "featured": false,
                    "filters": {
                      "all_of": [
                        {
                          "MIN_PRICE": {
                            "values": 999.99,
                            "inclusion": true
                          }
                        },
                        {
                          "CURRENCY": {
                            "values": "USD"
                          }
                        },
                        {
                          "CUSTOM_LABEL_0": {
                            "values": [
                              "Luxury Items"
                            ]
                          }
                        }
                      ]
                    }
                  }
                },
                "ManyFiltersUsingAnyOf": {
                  "summary": "An more complete example that applies \"any of the following filters\".",
                  "description": "The use of \"any_of\" creates a Product Group where any of the individual filters\ncan add products to the Product Group independently.\n",
                  "value": {
                    "name": "Many Filters using \"any_of\"",
                    "featured": false,
                    "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": [
                              "MALE",
                              "FEMALE",
                              "ALL"
                            ],
                            "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
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogsProductGroup"
                }
              }
            },
            "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+$\"}"
                    }
                  }
                }
              }
            }
          },
          "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. Account is disapproved."
                    }
                  },
                  "MerchantUnderReview": {
                    "value": {
                      "code": 2626,
                      "message": "Sorry, you cannot perform this action. Account is under review."
                    }
                  }
                }
              }
            }
          },
          "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": [
          "catalogs"
        ]
      }
    },
    "/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"
                    },
                    {
                      "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"
        ]
      }
    },
    "/integrations/commerce": {
      "post": {
        "summary": "Create commerce integration",
        "description": "Create commerce integration metadata to link an external business ID with a Pinterest merchant & ad account.",
        "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",
        "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",
        "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.",
        "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"
        ]
      }
    },
    "/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"
            ]
          }
        ],
        "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.\nThe `display_name` attribute will match how the metric is named in our native tools like Ads Manager.\nSee <a href='/docs/content/analytics/'>Organic Analytics</a> and <a href='/docs/ads/ad-analytics-reporting/'>Ads Analytics</a> for more information.",
        "operationId": "delivery_metrics/get",
        "security": [
          {
            "pinterest_oauth2": [
              "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/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"
            ]
          }
        ],
        "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>\n<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"
            ]
          }
        ],
        "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"
          }
        ],
        "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/pins": {
      "get": {
        "description": "Search for pins for the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nIf 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/reference/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"
                    },
                    {
                      "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"
        ]
      }
    },
    "/terms/related": {
      "get": {
        "summary": "List related terms",
        "description": "Get a list of terms logically related to each input term. <p/>\nExample: 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"
                }
              }
            }
          }
        }
      }
    },
    "/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"
            ]
          }
        ],
        "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’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=\"https://developers.pinterest.com/docs/conversions/pinterest-tag/\">Pinterest Tag</a><p/>\n<a class=\"reference external\" href=\"https://developers.pinterest.com/docs/conversions/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/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"
            ]
          }
        ],
        "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"
                    },
                    {
                      "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"
            ]
          }
        ],
        "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}/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"
            ]
          }
        ],
        "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}/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. \nA string message is returned indicating the status of the delete operation.\n\nNote: This endpoint is only allowed in the Pinterest API Sandbox (https://api-sandbox.pinterest.com/v5). \nGo to https://developers.pinterest.com/docs/dev-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"
        ]
      }
    },
    "/users/{username}/interests/follow": {
      "get": {
        "summary": "List following interests",
        "description": "Get a list of a user's following interests in one place.",
        "tags": [
          "interests"
        ],
        "operationId": "interests/followed_interests",
        "security": [
          {
            "pinterest_oauth2": [
              "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"
                    },
                    {
                      "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.",
              "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",
              "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"
      }
    },
    "schemas": {
      "Error": {
        "title": "Error",
        "type": "object",
        "properties": {
          "code": {
            "type": "integer"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "message"
        ]
      },
      "Paginated": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "bookmark": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "items"
        ]
      },
      "Account": {
        "type": "object",
        "readOnly": true,
        "properties": {
          "account_type": {
            "description": "Type of account",
            "type": "string",
            "enum": [
              "PINNER",
              "BUSINESS"
            ]
          },
          "profile_image": {
            "type": "string"
          },
          "website_url": {
            "type": "string"
          },
          "username": {
            "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."
          }
        }
      },
      "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. Not currently available. Using this field will generate an error.",
            "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. Not currently available. Using this field will generate an error.",
            "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
          }
        }
      },
      "AdCreateRequest": {
        "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"
            ]
          }
        ]
      },
      "AdPinId": {
        "type": "object",
        "properties": {
          "pin_id": {
            "description": "Pin ID.",
            "example": "394205773611545468",
            "type": "string",
            "pattern": "^\\d+$"
          }
        }
      },
      "AnalyticsResponse": {
        "type": "object",
        "additionalProperties": {
          "$ref": "#/components/schemas/AnalyticsMetricsResponse"
        }
      },
      "AnalyticsMetricsResponse": {
        "type": "object",
        "properties": {
          "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": {
                  "$ref": "#/components/schemas/Metrics"
                }
              }
            },
            "type": "array"
          },
          "summary_metrics": {
            "description": "The metric name and value over the requested period for each requested metric",
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "example": {
              "SAVE": 20,
              "SAVE_RATE": 0.18,
              "IMPRESSION": 240,
              "OUTBOUND_CLICK": 200,
              "PIN_CLICK": 37,
              "VIDEO_10S_VIEW": 2,
              "VIDEO_V50_WATCH_TIME": 10031,
              "QUARTILE_95_PERCENT_VIEW": 8,
              "VIDEO_AVG_WATCH_TIME": 2507.75,
              "VIDEO_START": 2,
              "VIDEO_MRC_VIEW": 2
            }
          }
        }
      },
      "AdGroupSummaryStatus": {
        "type": "string",
        "description": "Summary status for ad group",
        "example": "RUNNING",
        "enum": [
          "RUNNING",
          "PAUSED",
          "NOT_STARTED",
          "COMPLETED",
          "ADVERTISER_DISABLED",
          "ARCHIVED"
        ]
      },
      "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"
              }
            }
          }
        ]
      },
      "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"
          }
        }
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "ActionType": {
        "type": "string",
        "description": "Ad group billable event type.",
        "example": "CLICKTHROUGH",
        "enum": [
          "CLICKTHROUGH",
          "IMPRESSION",
          "VIDEO_V_50_MRC"
        ]
      },
      "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, VIDEO_VIEW/VIDEO_V_50_MRC.",
            "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": "Ad group start time. Unix timestamp in seconds. Defaults to current time.",
            "type": "integer",
            "example": 5686848000,
            "nullable": true
          },
          "end_time": {
            "description": "Ad group end time. Unix timestamp in seconds.",
            "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=\"https://developers.pinterest.com/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=\"https://developers.pinterest.com/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. Also known as <a href=\"https://help.pinterest.com/en/business/article/expanded-targeting\" target=\"_blank\">\"expanded targeting\"</a>.",
            "example": true,
            "nullable": true
          },
          "placement_group": {
            "type": "string",
            "allOf": [
              {
                "$ref": "#/components/schemas/PlacementGroupType"
              }
            ],
            "description": "<a href=\"https://developers.pinterest.com/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",
            "enum": [
              "AUTOMATIC_BID",
              "MAX_BID",
              "TARGET_AVG",
              null
            ],
            "example": "MAX_BID",
            "title": "BidStrategyType",
            "type": "string"
          }
        }
      },
      "AdGroupCreateRequest": {
        "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. Also known as <a href=\"https://help.pinterest.com/en/business/article/expanded-targeting\" target=\"_blank\">\"expanded targeting\"</a>.",
                    "example": true
                  }
                ],
                "default": true
              },
              "budget_type": {
                "type": "string",
                "allOf": [
                  {
                    "$ref": "#/components/schemas/BudgetType"
                  }
                ],
                "default": "DAILY"
              }
            },
            "required": [
              "billable_event",
              "campaign_id",
              "name"
            ]
          }
        ]
      },
      "AdGroupArrayResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AdGroupArrayResponseElement"
            }
          }
        }
      },
      "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."
              }
            }
          }
        ]
      },
      "AdGroupArrayResponseElement": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/AdGroupResponse"
          },
          "exceptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Exception"
            }
          }
        }
      },
      "AdGroupUpdateRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AdGroupCommon"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "description": "Ad group ID.",
                "type": "string",
                "pattern": "^\\d+$",
                "example": "2680060704746"
              }
            },
            "required": [
              "id"
            ]
          }
        ]
      },
      "AdGroupsAnalyticsResponse": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "AD_GROUP_ID": {
              "description": "The ID of the ad 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": [
            "AD_GROUP_ID"
          ],
          "additionalProperties": true,
          "example": {
            "DATE": "2021-04-01",
            "AD_GROUP_ID": "547602124502",
            "SPEND_IN_DOLLAR": 30,
            "TOTAL_CLICKTHROUGH": 216
          }
        }
      },
      "AdAccountsCountryResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AdAccountsCountryResponseData"
            }
          }
        }
      },
      "AdAccountsCountryResponseData": {
        "type": "object",
        "properties": {
          "code": {
            "$ref": "#/components/schemas/Country",
            "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"
          }
        }
      },
      "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"
          }
        ]
      },
      "AdPreviewURLResponse": {
        "example": {
          "url": "https://ads.pinterest.com/ad-preview/58f1a0e9ab0bd0f99462a0e4c5dd7e8297888c8a36331e88f757abe8f0295d31/"
        },
        "properties": {
          "url": {
            "description": "'Preview URL, expires in 24 hours. Can be used in an iframe.\nFor example: https://ads.pinterest.com/ad-preview/74667c814dd2b19/\nThe 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"
      },
      "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"
              }
            }
          },
          "country": {
            "$ref": "#/components/schemas/Country"
          },
          "currency": {
            "$ref": "#/components/schemas/Currency"
          },
          "permissions": {
            "title": "permissions",
            "type": "array",
            "items": {
              "type": "string",
              "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"
          }
        }
      },
      "AdAccountCreateRequest": {
        "title": "AdAccountCreate",
        "type": "object",
        "example": {
          "country": "US",
          "owner_user_id": "383791336903426391",
          "name": "ACME Tools"
        },
        "properties": {
          "country": {
            "$ref": "#/components/schemas/Country"
          },
          "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"
          }
        }
      },
      "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
          }
        }
      },
      "AdsAnalyticsGetAsyncResponse": {
        "type": "object",
        "properties": {
          "report_status": {
            "type": "string",
            "allOf": [
              {
                "$ref": "#/components/schemas/BulkReportingJobStatus"
              }
            ]
          },
          "url": {
            "type": "string",
            "nullable": true
          },
          "size": {
            "type": "number",
            "nullable": true
          }
        }
      },
      "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": [
              {
                "type": "object",
                "properties": {
                  "campaign_ids": {
                    "type": "array",
                    "description": "List of campaign ids",
                    "example": [
                      "12345678"
                    ],
                    "items": {
                      "type": "string",
                      "pattern": "^\\d+$"
                    },
                    "maxItems": 500,
                    "minItems": 1
                  }
                }
              },
              {
                "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
                  }
                }
              },
              {
                "type": "object",
                "properties": {
                  "campaign_objective_types": {
                    "type": "array",
                    "description": "List of values for filtering. [\"WEB_SESSIONS\"] in BETA.",
                    "example": [
                      "AWARENESS",
                      "VIDEO_VIEW"
                    ],
                    "items": {
                      "$ref": "#/components/schemas/ObjectiveType"
                    },
                    "maxItems": 6,
                    "minItems": 1
                  }
                }
              },
              {
                "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
                  }
                }
              },
              {
                "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",
                    "example": [
                      "12345678"
                    ],
                    "items": {
                      "type": "string",
                      "pattern": "^\\d+$"
                    },
                    "maxItems": 500,
                    "minItems": 1
                  }
                }
              },
              {
                "type": "object",
                "properties": {
                  "ad_statuses": {
                    "type": "array",
                    "description": "List of values for filtering",
                    "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",
                "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 report data",
                "type": "string",
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DataOutputFormat"
                  }
                ],
                "default": "JSON"
              }
            }
          }
        ]
      },
      "AdsAnalyticsCreateAsyncResponse": {
        "type": "object",
        "properties": {
          "report_status": {
            "type": "string",
            "allOf": [
              {
                "$ref": "#/components/schemas/BulkReportingJobStatus"
              }
            ]
          },
          "token": {
            "type": "string"
          },
          "message": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "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.",
            "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"
            }
          }
        }
      },
      "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"
        ]
      },
      "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"
            }
          }
        }
      },
      "LeadFormQuestionType": {
        "type": "string",
        "description": "Lead form question type",
        "example": "FIRST_NAME",
        "enum": [
          "CUSTOM",
          "FULL_NAME",
          "FIRST_NAME",
          "LAST_NAME",
          "EMAIL",
          "PHONE_NUMBER",
          "ZIP_CODE",
          "AGE",
          "GENDER",
          "CITY",
          "COUNTRY",
          "PREFERRED_CONTACT_METHOD",
          "STATE_PROVINCE"
        ]
      },
      "LeadFormQuestionFieldType": {
        "type": "string",
        "description": "Lead form question field type",
        "example": "RADIO_LIST",
        "nullable": true,
        "enum": [
          "TEXT_FIELD",
          "TEXT_AREA",
          "RADIO_LIST",
          "CHECKBOX",
          "DROPDOWN",
          null
        ]
      },
      "AdUpdateRequest": {
        "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"
              }
            },
            "required": [
              "id"
            ]
          }
        ]
      },
      "AudienceInsightType": {
        "default": "YOUR_TOTAL_AUDIENCE",
        "type": "string",
        "example": "YOUR_TOTAL_AUDIENCE",
        "enum": [
          "YOUR_TOTAL_AUDIENCE",
          "YOUR_ENGAGED_AUDIENCE",
          "PINTEREST_TOTAL_AUDIENCE"
        ]
      },
      "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"
          }
        },
        "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"
          }
        }
      },
      "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"
          }
        }
      },
      "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",
                "allOf": [
                  {
                    "$ref": "#/components/schemas/AudienceType"
                  },
                  {
                    "title": "audience_type",
                    "description": "<a href=\"/docs/reference/glossary/#Audience Types\">Audience types</a>: ACTALIKE, ENGAGEMENT, CUSTOMER_LIST and VISITOR. Values are case-sensitive."
                  }
                ]
              }
            }
          }
        ]
      },
      "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"
              }
            }
          }
        ]
      },
      "AudienceDataParty": {
        "description": "Whether the data is owned by the partner (1p) or by the data provider (3p)",
        "type": "string",
        "enum": [
          "1p",
          "3p"
        ]
      },
      "AudienceDescription": {
        "title": "description",
        "description": "Audience description.",
        "type": "string",
        "example": "string"
      },
      "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"
          }
        }
      },
      "AudienceInsightCategoryArrayResponse": {
        "deprecated": true,
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AudienceInsightCategoryCommon"
            }
          }
        }
      },
      "AudienceDefinitionScope": {
        "description": "Generated audience scope to request.",
        "type": "string",
        "properties": {
          "scope": {
            "enum": [
              "PARTNER",
              "PINTEREST"
            ]
          }
        }
      },
      "AudienceDefinitionType": {
        "description": "Generated audience type to request.",
        "type": "string",
        "properties": {
          "scope": {
            "enum": [
              "IMPRESSION_PLUS_ENGAGEMENT",
              "ENGAGEMENT"
            ]
          }
        }
      },
      "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"
            }
          }
        }
      },
      "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
        }
      },
      "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": {
            "$ref": "#/components/schemas/AudienceDefinitionType"
          },
          "scope": {
            "$ref": "#/components/schemas/AudienceDefinitionScope"
          }
        },
        "example": {
          "date": "2022-10-09",
          "scope": "PARTNER",
          "type": "IMPRESSION_PLUS_ENGAGEMENT"
        }
      },
      "AudienceDefinitionResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AudienceDefinition"
            }
          }
        }
      },
      "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=\"https://developers.pinterest.com/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’s `rule`; however, you **must** specify an `event` for the `event_data` fields to be evaluated. Besides what’s 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": 30,
            "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"
      },
      "AudienceSharingType": {
        "description": "Audience sharing type: [\"CUSTOM\", \"SYNDICATED\"]",
        "type": "string",
        "enum": [
          "CUSTOM",
          "SYNDICATED"
        ]
      },
      "AudienceType": {
        "description": "Audience type",
        "enum": [
          "CUSTOMER_LIST",
          "VISITOR",
          "ENGAGEMENT",
          "ACTALIKE"
        ],
        "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": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AudienceCommon"
          },
          {
            "title": "AudienceUpdateRequest",
            "type": "object",
            "properties": {
              "description": {
                "$ref": "#/components/schemas/AudienceDescription"
              },
              "operation_type": {
                "$ref": "#/components/schemas/AudienceUpdateOperationType"
              }
            }
          }
        ]
      },
      "BatchOperation": {
        "description": "The operation performed by the batch",
        "example": "UPDATE",
        "type": "string",
        "enum": [
          "UPDATE",
          "CREATE",
          "DELETE_DISCONTINUED"
        ]
      },
      "BatchOperationStatus": {
        "description": "The status of the operation performed by the batch",
        "example": "PROCESSING",
        "type": "string",
        "enum": [
          "PROCESSING",
          "COMPLETED"
        ]
      },
      "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": {
            "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\"]}'",
            "example": {
              "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"
              ]
            },
            "properties": {
              "AGE_BUCKET": {
                "description": "Values: [\"18-24\",\"21+\",\"25-34\",\"35-44\", \"45-49\",\"50-54\",\"55-64\",\"65+\"]",
                "example": [
                  "25-34"
                ],
                "items": {
                  "type": "string"
                },
                "title": "AGE_BUCKET",
                "type": "array"
              },
              "APPTYPE": {
                "description": "Values: [\"android_mobile\", \"android_tablet\", \"ipad\", \"iphone\", \"web\", \"web_mobile\"]",
                "example": [
                  "iphone"
                ],
                "items": {
                  "type": "string"
                },
                "title": "APPTYPE",
                "type": "array"
              },
              "AUDIENCE_EXCLUDE": {
                "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.",
                "example": [
                  "2542620905475"
                ],
                "items": {
                  "type": "string"
                },
                "title": "AUDIENCE_EXCLUDE",
                "type": "array"
              },
              "AUDIENCE_INCLUDE": {
                "description": "Targeted customer list IDs. For example: [\"2542620905473\"]. Audience lists need to have at least 100 people with Pinterest accounts in them",
                "example": [
                  "2542620905473"
                ],
                "items": {
                  "type": "string"
                },
                "title": "AUDIENCE_INCLUDE",
                "type": "array"
              },
              "GENDER": {
                "description": "Targeted genders. Values: [\"unknown\",\"male\",\"female\"]",
                "example": [
                  "male"
                ],
                "items": {
                  "type": "string"
                },
                "title": "GENDER",
                "type": "array"
              },
              "GEO": {
                "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.",
                "example": [
                  "BE-VOV"
                ],
                "items": {
                  "type": "string"
                },
                "title": "GEO",
                "type": "array"
              },
              "INTEREST": {
                "description": "<a href=\"https://docs.google.com/spreadsheets/d/1HxL-0Z3p2fgxis9YBP2HWC3tvPrs1hAuHDRtH-NJTIM/edit#gid=118370875\" target=\"_blank\">Interest object IDs</a>.",
                "example": [
                  "925056443165"
                ],
                "items": {
                  "type": "string"
                },
                "title": "INTEREST",
                "type": "array"
              },
              "LOCALE": {
                "description": "24 <a href=\"https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes\" target=\"_blank\">ISO 639-1 two letter language codes</a>. Values: [\"cs\",\"da\",\"de\",\"el\",\"en\",\"es\",\"fi\",\"fr\",\"hu\", \"id\",\"in\",\"it\",\"ja\",\"ko\",\"no\",\"pl\",\"pt\",\"ro\",\"ru\",\"sk\",\"sv\",\"tr\",\"uk\",\"zh\"]",
                "example": [
                  "cs"
                ],
                "items": {
                  "type": "string"
                },
                "title": "LOCALE",
                "type": "array"
              },
              "LOCATION": {
                "description": "22 <a href=\"https://www.nationsonline.org/oneworld/country_code_list.htm\" target=\"_blank\">ISO Alpha 2</a> two letter country codes or <a href=\"https://help.pinterest.com/sub/helpcenter/partner/pinterest_location_targeting_codes.xlsx\" target=\"_blank\">US Nielsen DMA (Designated Market Area) codes</a> (location region codes) (e.g., [\"US\", \"807\"]). For complete list, <a href=\"https://help.pinterest.com/sub/helpcenter/partner/pinterest_location_targeting_codes.xlsx\">click here</a>. Location-Country and Location-Metro codes apply.",
                "example": [
                  "US"
                ],
                "items": {
                  "type": "string"
                },
                "title": "LOCATION",
                "type": "array"
              },
              "SHOPPING_RETARGETING": {
                "items": {
                  "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",
                  "type": "object"
                },
                "title": "SHOPPING_RETARGETING",
                "type": "array"
              },
              "TARGETING_STRATEGY": {
                "description": "Values: [\"CHOOSE_YOUR_OWN\", \"FIND_NEW_CUSTOMERS\", \"RECONNECT_WITH_USERS\"]",
                "example": [
                  "CHOOSE_YOUR_OWN"
                ],
                "items": {
                  "type": "string"
                },
                "title": "TARGETING_STRATEGY",
                "type": "array"
              }
            },
            "title": "TargetingSpec",
            "type": "object"
          }
        },
        "required": [
          "bid_floor_specs"
        ],
        "title": "BidFloorBody",
        "type": "object"
      },
      "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": {
            "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>",
            "enum": [
              "PUBLIC",
              "PROTECTED",
              "SECRET"
            ]
          }
        },
        "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
          }
        }
      },
      "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
          }
        }
      },
      "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.",
        "example": "DAILY",
        "enum": [
          "DAILY",
          "LIFETIME",
          "CBO_ADGROUP"
        ],
        "type": "string"
      },
      "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"
            }
          }
        }
      },
      "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"
            }
          }
        }
      },
      "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"
        ]
      },
      "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/(...)"
          }
        }
      },
      "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"
        ]
      },
      "BulkOutputFormat": {
        "type": "string",
        "description": "Bulk file output format",
        "enum": [
          "CSV",
          "JSON"
        ]
      },
      "CampaignCommon": {
        "type": "object",
        "description": "Campaign Data",
        "properties": {
          "ad_account_id": {
            "description": "Campaign's Advertiser ID.",
            "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.",
            "example": 1432744744,
            "type": "integer",
            "nullable": true
          },
          "daily_spend_cap": {
            "description": "Campaign daily spending cap.",
            "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": "Campaign start time. Unix timestamp in seconds. Only used for Campaign Budget Optimization (CBO) campaigns.",
            "example": 1580865126,
            "nullable": true
          },
          "end_time": {
            "type": "integer",
            "description": "Campaign end time. Unix timestamp in seconds. Only used for Campaign Budget Optimization (CBO) campaigns.",
            "example": 1644023526,
            "nullable": true
          },
          "summary_status": {
            "type": "string",
            "description": "Summary status for campaigns",
            "example": "RUNNING",
            "enum": [
              "RUNNING",
              "PAUSED",
              "NOT_STARTED",
              "COMPLETED",
              "ADVERTISER_DISABLED",
              "ARCHIVED"
            ]
          }
        }
      },
      "CampaignCreateCommon": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/CampaignCommon"
          },
          {
            "properties": {
              "status": {
                "type": "string",
                "default": "ACTIVE",
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EntityStatus"
                  }
                ]
              },
              "is_campaign_budget_optimization": {
                "type": "boolean",
                "default": false,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CampaignIsCampaignBudgetOptimization"
                  }
                ]
              },
              "is_flexible_daily_budgets": {
                "type": "boolean",
                "default": false,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CampaignIsFlexibleDailyBudgets"
                  }
                ]
              },
              "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_automated_campaign": {
                "type": "boolean",
                "default": false,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CampaignIsAutomatedCampaign"
                  }
                ]
              }
            }
          }
        ]
      },
      "CampaignCreateRequest": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/CampaignCreateCommon"
          },
          {
            "required": [
              "name",
              "objective_type",
              "ad_account_id"
            ],
            "properties": {
              "objective_type": {
                "$ref": "#/components/schemas/ObjectiveType"
              }
            }
          }
        ]
      },
      "CampaignCreateResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignCreateResponseItem"
            }
          }
        }
      },
      "CampaignCreateResponseData": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/CampaignCreateCommon"
          },
          {
            "$ref": "#/components/schemas/CampaignResponse"
          },
          {
            "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"
      },
      "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,
        "default": false
      },
      "CampaignIsAutomatedCampaign": {
        "type": "boolean",
        "description": "Specifies whether the campaign was created in the automated campaign flow",
        "example": true,
        "default": false
      },
      "CampaignIsFlexibleDailyBudgets": {
        "type": "boolean",
        "description": "Determine if a campaign has flexible daily budgets setup.",
        "example": true,
        "default": false
      },
      "CampaignResponse": {
        "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_flexible_daily_budgets": {
                "type": "boolean",
                "description": "Determines if a campaign has flexible daily budgets setup.",
                "example": true,
                "nullable": true
              },
              "is_campaign_budget_optimization": {
                "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
              }
            }
          }
        ]
      },
      "CampaignsAnalyticsResponse": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "CAMPAIGN_ID": {
              "description": "The ID of the campaing 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": [
            "CAMPAIGN_ID"
          ],
          "additionalProperties": true,
          "example": {
            "DATE": "2021-04-01",
            "CAMPAIGN_ID": "547602124502",
            "SPEND_IN_DOLLAR": 30,
            "TOTAL_CLICKTHROUGH": 216
          }
        }
      },
      "CampaignSummaryStatus": {
        "type": "string",
        "description": "Summary status for campaign",
        "example": "RUNNING",
        "enum": [
          "RUNNING",
          "PAUSED",
          "NOT_STARTED",
          "COMPLETED",
          "ADVERTISER_DISABLED",
          "ARCHIVED"
        ]
      },
      "CampaignUpdateResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CampaignCreateResponse"
          }
        ]
      },
      "CampaignUpdateRequest": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/CampaignId"
          },
          {
            "$ref": "#/components/schemas/CampaignCommon"
          },
          {
            "$ref": "#/components/schemas/CampaignCreateCommon"
          },
          {
            "properties": {
              "is_campaign_budget_optimization": {
                "type": "boolean",
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CampaignIsCampaignBudgetOptimization"
                  }
                ]
              },
              "is_flexible_daily_budgets": {
                "type": "boolean",
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CampaignIsFlexibleDailyBudgets"
                  }
                ]
              },
              "is_automated_campaign": {
                "type": "boolean",
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/CampaignIsAutomatedCampaign"
                  }
                ]
              },
              "status": {
                "type": "string",
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/EntityStatus"
                  }
                ]
              }
            },
            "required": [
              "id",
              "ad_account_id"
            ]
          }
        ]
      },
      "CatalogProductGroup": {
        "description": "non-promoted catalog product group entity",
        "properties": {
          "id": {
            "description": "ID of the catalog product group.",
            "example": "2680059592705",
            "title": "id",
            "type": "string"
          },
          "merchant_id": {
            "description": "Merchant ID pertaining to the owner of the catalog product group.",
            "example": "2680059592705",
            "pattern": "^\\d+$",
            "title": "merchant_id",
            "type": "string"
          },
          "name": {
            "description": "Name of catalog product group",
            "example": "Most Popular",
            "title": "name",
            "type": "string"
          },
          "filters": {
            "description": "Object holding a list of filters",
            "example": {
              "1": [
                "123chars_title"
              ]
            },
            "title": "filters",
            "type": "object"
          },
          "filter_v2": {
            "description": "Object holding a list of filters",
            "example": {
              "1": [
                "123chars_title"
              ]
            },
            "title": "filters",
            "type": "object"
          },
          "type": {
            "$ref": "#/components/schemas/Board"
          },
          "status": {
            "$ref": "#/components/schemas/EntityStatus"
          },
          "feed_profile_id": {
            "description": "id of the feed profile belonging to this catalog product group",
            "pattern": "^\\d+$",
            "title": "feed_profile_id",
            "type": "string"
          },
          "created_at": {
            "description": "Unix timestamp in seconds of when catalog product group was created.",
            "example": 1621350033000,
            "title": "created_at",
            "type": "integer"
          },
          "last_update": {
            "description": "Unix timestamp in seconds of last time catalog product group was updated.",
            "example": 1622742155000,
            "title": "last_update",
            "type": "integer"
          },
          "product_count": {
            "description": "Amount of products in the catalog product group",
            "example": 6,
            "title": "product_count",
            "type": "integer"
          },
          "featured_position": {
            "description": "index of the featured position of the catalog product group",
            "example": 2,
            "title": "featured_position",
            "type": "integer"
          }
        },
        "title": "CatalogProductGroup",
        "type": "object"
      },
      "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"
          }
        }
      },
      "CatalogsFeed": {
        "type": "object",
        "title": "catalogs_feed",
        "description": "Catalogs Feed object",
        "allOf": [
          {
            "$ref": "#/components/schemas/CatalogsDbItem"
          },
          {
            "type": "object",
            "title": "feed_fields",
            "properties": {
              "default_country": {
                "$ref": "#/components/schemas/Country"
              },
              "default_availability": {
                "$ref": "#/components/schemas/ProductAvailabilityType"
              },
              "default_currency": {
                "$ref": "#/components/schemas/NullableCurrency"
              },
              "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"
              },
              "default_locale": {
                "description": "The locale used within a feed for product descriptions.",
                "example": "en-US",
                "type": "string"
              },
              "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"
              }
            },
            "required": [
              "credentials",
              "default_availability",
              "default_country",
              "default_currency",
              "default_locale",
              "format",
              "location",
              "name",
              "preferred_processing_schedule",
              "status"
            ]
          }
        ]
      },
      "CatalogsFeedCredentials": {
        "type": "object",
        "nullable": true,
        "description": "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"
          }
        },
        "required": [
          "errors",
          "info"
        ]
      },
      "CatalogsFeedIngestionErrors": {
        "type": "object",
        "properties": {
          "IMAGE_DOWNLOAD_ERROR": {
            "type": "integer",
            "description": "Some items include images that can't be found."
          },
          "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."
          }
        }
      },
      "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."
          }
        }
      },
      "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"
            ]
          }
        ]
      },
      "CatalogsFeedProcessingStatus": {
        "type": "string",
        "enum": [
          "COMPLETED",
          "COMPLETED_EARLY",
          "DISAPPROVED",
          "FAILED",
          "PROCESSING",
          "QUEUED_FOR_PROCESSING",
          "UNDER_APPEAL",
          "UNDER_REVIEW"
        ]
      },
      "CatalogsFeedProcessingSchedule": {
        "type": "object",
        "title": "catalogs_processing_schedule",
        "description": "Optional daily processing schedule. 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"
        ]
      },
      "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"
          }
        }
      },
      "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’t 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."
          },
          "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_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."
          },
          "DUPLICATE_PRODUCTS": {
            "type": "integer",
            "description": "Some products are duplicated."
          },
          "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."
          },
          "AVAILABILITY_NORMALIZED": {
            "type": "integer",
            "description": "Some items include availability values that are formatted incorrectly and have been automatically corrected."
          },
          "CONDITION_NORMALIZED": {
            "type": "integer",
            "description": "Some items include condition values that are formatted incorrectly and have been automatically corrected."
          },
          "GENDER_NORMALIZED": {
            "type": "integer",
            "description": "Some items include gender values that are formatted incorrectly and have been automatically corrected."
          },
          "SIZE_TYPE_NORMALIZED": {
            "type": "integer",
            "description": "Some items include size_type values that are formatted incorrectly and have been automatically corrected."
          },
          "AGE_GROUP_NORMALIZED": {
            "type": "integer",
            "description": "Some items include age_group values that are formatted incorrectly and have been automatically corrected."
          },
          "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": "feeds_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.",
        "properties": {
          "default_country": {
            "$ref": "#/components/schemas/Country"
          },
          "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"
          },
          "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"
          }
        },
        "required": [
          "format",
          "location",
          "name"
        ]
      },
      "CatalogsFeedsUpdateRequest": {
        "type": "object",
        "title": "catalogs_feeds_update_request",
        "description": "Request object for updating a feed.",
        "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"
        ]
      },
      "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": {
          "items": {
            "description": "Array with the catalogs items processing records part of the catalogs items batch",
            "items": {
              "$ref": "#/components/schemas/ItemProcessingRecord"
            },
            "type": "array"
          },
          "batch_id": {
            "description": "Id of the catalogs items batch",
            "example": "595953100599279259-66753b9bb65c46c49bd8503b27fecf9e",
            "type": "string"
          },
          "created_time": {
            "description": "Time of the batch creation: YYYY-MM-DD'T'hh:mm:ssTZD",
            "example": "2020-01-01T20:10:40-00:00",
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "completed_time": {
            "description": "Time of the batch completion: YYYY-MM-DD'T'hh:mm:ssTZD",
            "example": "2022-03-10T15:37:10-00:00",
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/BatchOperationStatus"
          }
        }
      },
      "CatalogsItemsBatchRequest": {
        "type": "object",
        "description": "Request object of catalogs items batch",
        "oneOf": [
          {
            "$ref": "#/components/schemas/CatalogsItemsUpdateBatchRequest"
          },
          {
            "$ref": "#/components/schemas/CatalogsItemsCreateBatchRequest"
          },
          {
            "$ref": "#/components/schemas/CatalogsItemsDeleteDiscontinuedBatchRequest"
          }
        ],
        "discriminator": {
          "propertyName": "operation",
          "mapping": {
            "UPDATE": "#/components/schemas/CatalogsItemsUpdateBatchRequest",
            "CREATE": "#/components/schemas/CatalogsItemsCreateBatchRequest",
            "DELETE_DISCONTINUED": "#/components/schemas/CatalogsItemsDeleteDiscontinuedBatchRequest"
          }
        }
      },
      "CatalogsItemsCreateBatchRequest": {
        "description": "Request object to create catalogs items",
        "type": "object",
        "properties": {
          "country": {
            "$ref": "#/components/schemas/Country"
          },
          "language": {
            "$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"
        ]
      },
      "CatalogsItemsUpdateBatchRequest": {
        "description": "Request object to update catalogs items",
        "type": "object",
        "properties": {
          "country": {
            "$ref": "#/components/schemas/Country"
          },
          "language": {
            "$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"
        ]
      },
      "CatalogsItemsDeleteDiscontinuedBatchRequest": {
        "description": "Request object to discontinue catalogs items",
        "type": "object",
        "properties": {
          "country": {
            "$ref": "#/components/schemas/Country"
          },
          "language": {
            "$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"
        ]
      },
      "CatalogsListProductsByFilterRequest": {
        "description": "Request object to list products for a given product group filter.",
        "type": "object",
        "oneOf": [
          {
            "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"
            ]
          }
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "CatalogsItemValidationIssue": {
        "type": "string",
        "enum": [
          "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",
          "AGE_GROUP_NORMALIZED",
          "ANDROID_DEEP_LINK_INVALID",
          "AVAILABILITY_DATE_INVALID",
          "AVAILABILITY_INVALID",
          "AVAILABILITY_NORMALIZED",
          "BLOCKLISTED_IMAGE_SIGNATURE",
          "CONDITION_NORMALIZED",
          "COUNTRY_DOES_NOT_MAP_TO_CURRENCY",
          "CUSTOM_LABEL_LENGTH_TOO_LONG",
          "DESCRIPTION_LENGTH_TOO_LONG",
          "DESCRIPTION_MISSING",
          "DUPLICATE_PRODUCTS",
          "EXPIRATION_DATE_INVALID",
          "GENDER_INVALID",
          "GENDER_NORMALIZED",
          "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",
          "SIZE_TYPE_NORMALIZED",
          "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"
        ]
      },
      "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."
          },
          "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."
          }
        }
      },
      "CatalogsItemValidationWarnings": {
        "type": "object",
        "properties": {
          "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."
          },
          "AGE_GROUP_NORMALIZED": {
            "$ref": "#/components/schemas/CatalogsItemValidationDetails",
            "description": "Item includes an age_group value that is formatted incorrectly and has been automatically corrected."
          },
          "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."
          },
          "AVAILABILITY_NORMALIZED": {
            "$ref": "#/components/schemas/CatalogsItemValidationDetails",
            "description": "Item includes an availability value that is formatted incorrectly and has been automatically corrected."
          },
          "CONDITION_NORMALIZED": {
            "$ref": "#/components/schemas/CatalogsItemValidationDetails",
            "description": "Item includes a condition value that is formatted incorrectly and has been automatically corrected."
          },
          "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."
          },
          "DUPLICATE_PRODUCTS": {
            "$ref": "#/components/schemas/CatalogsItemValidationDetails",
            "description": "This product is duplicated. The duplicate entry will not be published."
          },
          "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."
          },
          "GENDER_NORMALIZED": {
            "$ref": "#/components/schemas/CatalogsItemValidationDetails",
            "description": "Item includes a gender value that is formatted incorrectly and has been automatically corrected."
          },
          "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."
          },
          "SIZE_TYPE_NORMALIZED": {
            "$ref": "#/components/schemas/CatalogsItemValidationDetails",
            "description": "Item includes a size_type value that is formatted incorrectly and has been automatically corrected."
          },
          "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."
          }
        }
      },
      "CatalogsProductGroupType": {
        "type": "string",
        "title": "product_group_type",
        "description": "<p>Catalog product group type</p>\n<p>MERCHANT_CREATED: Product groups created by merchants.\n<br>ALL_PRODUCTS: Consists of every product in your latest successful feed upload.\n<br>BEST_DEALS: Consists of products with the deepest drop in price.\n<br>PINNER_FAVORITES: Consists of products that are resonating most with people on Pinterest, based on engagement.\n<br>TOP_SELLERS: Consists of products with the highest conversion rate, if you have the conversion tag installed.\n<br>BACK_IN_STOCK: Consists of products that were previously out of stock and are now in stock.\n<br>NEW_ARRIVALS: Consists of products that are new to your Catalog.\n<br>SHOPIFY_COLLECTION: Product groups created based on Shopify Product Collections.\n<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"
      },
      "CatalogsProductGroupStatus": {
        "type": "string",
        "enum": [
          "ACTIVE",
          "INACTIVE"
        ]
      },
      "CatalogsProductGroup": {
        "type": "object",
        "title": "catalogs_product_group",
        "description": "catalog product group entity",
        "oneOf": [
          {
            "type": "object",
            "title": "catalogs_product_group_feed_based_case",
            "properties": {
              "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": {
                "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"
              },
              "feed_id": {
                "description": "id of the catalogs feed belonging to this catalog product group",
                "example": "2680059592705",
                "type": "string",
                "pattern": "^\\d+$"
              }
            },
            "required": [
              "filters",
              "id",
              "feed_id"
            ]
          },
          {
            "type": "object",
            "title": "catalogs_product_group_merchant_based_case",
            "properties": {
              "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": {
                "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"
              },
              "feed_id": {
                "example": null,
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            },
            "required": [
              "filters",
              "id",
              "feed_id"
            ]
          }
        ]
      },
      "CatalogsProductGroupUpdateRequest": {
        "type": "object",
        "title": "product_groups_update_request",
        "description": "Request object for updating a product group.",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "is_featured": {
            "description": "boolean indicator of whether the product group is being featured or not",
            "type": "boolean"
          },
          "filters": {
            "$ref": "#/components/schemas/CatalogsProductGroupFiltersAllOfRequest"
          }
        }
      },
      "CatalogsProductGroupCreateRequest": {
        "type": "object",
        "title": "product_groups_create_request",
        "description": "Request object for creating a product group.",
        "oneOf": [
          {
            "type": "object",
            "title": "product_groups_create_request_feed_base_case",
            "properties": {
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string",
                "nullable": true
              },
              "is_featured": {
                "description": "boolean indicator of whether the product group is being featured or not",
                "type": "boolean",
                "default": false
              },
              "filters": {
                "$ref": "#/components/schemas/CatalogsProductGroupFiltersAllOfRequest"
              },
              "feed_id": {
                "description": "Catalog Feed id pertaining to the catalog product group.",
                "example": "2680059592705",
                "type": "string",
                "pattern": "^\\d+$"
              }
            },
            "required": [
              "name",
              "filters",
              "feed_id"
            ]
          }
        ]
      },
      "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"
          }
        ]
      },
      "CatalogsProductGroupFiltersAllOfRequest": {
        "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",
            "additionalProperties": false,
            "properties": {
              "any_of": {
                "type": "array",
                "items": {
                  "type": "object",
                  "$ref": "#/components/schemas/CatalogsProductGroupFilterKeys"
                },
                "minItems": 1
              }
            },
            "required": [
              "any_of"
            ]
          },
          {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "all_of": {
                "type": "array",
                "items": {
                  "type": "object",
                  "$ref": "#/components/schemas/CatalogsProductGroupFilterKeys"
                },
                "minItems": 1
              }
            },
            "required": [
              "all_of"
            ]
          }
        ]
      },
      "CatalogsProductGroupFiltersAnyOf": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "any_of": {
            "type": "array",
            "items": {
              "type": "object",
              "$ref": "#/components/schemas/CatalogsProductGroupFilterKeys"
            }
          }
        },
        "required": [
          "any_of"
        ]
      },
      "CatalogsProductGroupFiltersAllOf": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "all_of": {
            "type": "array",
            "items": {
              "type": "object",
              "$ref": "#/components/schemas/CatalogsProductGroupFilterKeys"
            }
          }
        },
        "required": [
          "all_of"
        ]
      },
      "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/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"
          }
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "CatalogsProductGroupProductCounts": {
        "title": "catalogs_product_group_product_counts",
        "description": "Product counts for a CatalogsProductGroup",
        "type": "object",
        "properties": {
          "in_stock": {
            "type": "number",
            "minimum": 0
          },
          "out_of_stock": {
            "type": "number",
            "minimum": 0
          },
          "preorder": {
            "type": "number",
            "minimum": 0
          },
          "total": {
            "type": "number",
            "minimum": 0
          }
        },
        "required": [
          "in_stock",
          "out_of_stock",
          "preorder",
          "total"
        ]
      },
      "CatalogsProductMetadata": {
        "type": "object",
        "description": "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"
        ]
      },
      "CatalogsProduct": {
        "type": "object",
        "properties": {
          "metadata": {
            "$ref": "#/components/schemas/CatalogsProductMetadata"
          },
          "pin": {
            "$ref": "#/components/schemas/Pin"
          }
        },
        "required": [
          "metadata",
          "pin"
        ]
      },
      "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"
            }
          ]
        }
      },
      "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"
      },
      "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"
          },
          "exceptions": {
            "description": "Customer list errors.",
            "title": "exceptions",
            "type": "object"
          }
        },
        "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"
          },
          "exceptions": {
            "$ref": "#/components/schemas/Exception",
            "title": "exceptions",
            "type": "object"
          }
        },
        "required": [
          "operation_type",
          "records"
        ],
        "title": "CustomerListUpdate",
        "type": "object"
      },
      "MinPriceFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "MIN_PRICE": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupPricingCriteria"
          }
        },
        "required": [
          "MIN_PRICE"
        ]
      },
      "MaxPriceFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "MAX_PRICE": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupPricingCriteria"
          }
        },
        "required": [
          "MAX_PRICE"
        ]
      },
      "CurrencyFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "CURRENCY": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupCurrencyCriteria"
          }
        },
        "required": [
          "CURRENCY"
        ]
      },
      "ItemIdFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "ITEM_ID": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "ITEM_ID"
        ]
      },
      "AvailabilityFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "AVAILABILITY": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "AVAILABILITY"
        ]
      },
      "BrandFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "BRAND": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "BRAND"
        ]
      },
      "ConditionFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "CONDITION": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "CONDITION"
        ]
      },
      "CustomLabel0Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "CUSTOM_LABEL_0": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "CUSTOM_LABEL_0"
        ]
      },
      "CustomLabel1Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "CUSTOM_LABEL_1": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "CUSTOM_LABEL_1"
        ]
      },
      "CustomLabel2Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "CUSTOM_LABEL_2": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "CUSTOM_LABEL_2"
        ]
      },
      "CustomLabel3Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "CUSTOM_LABEL_3": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "CUSTOM_LABEL_3"
        ]
      },
      "CustomLabel4Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "CUSTOM_LABEL_4": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "CUSTOM_LABEL_4"
        ]
      },
      "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."
          }
        }
      },
      "ItemGroupIdFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "ITEM_GROUP_ID": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "ITEM_GROUP_ID"
        ]
      },
      "GenderFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "GENDER": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringCriteria"
          }
        },
        "required": [
          "GENDER"
        ]
      },
      "GetAudiencesOrderBy": {
        "type": "string",
        "enum": [
          "NONE",
          "ID",
          "SIZE",
          "CREATION_DATE",
          "UPDATED_TIME",
          "NAME",
          "STATUS",
          "TYPE"
        ],
        "example": "NAME"
      },
      "ProductType4Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "PRODUCT_TYPE_4": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "PRODUCT_TYPE_4"
        ]
      },
      "ProductType3Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "PRODUCT_TYPE_3": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "PRODUCT_TYPE_3"
        ]
      },
      "ProductType2Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "PRODUCT_TYPE_2": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "PRODUCT_TYPE_2"
        ]
      },
      "ProductType1Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "PRODUCT_TYPE_1": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "PRODUCT_TYPE_1"
        ]
      },
      "ProductType0Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "PRODUCT_TYPE_0": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "PRODUCT_TYPE_0"
        ]
      },
      "GoogleProductCategory6Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "GOOGLE_PRODUCT_CATEGORY_6": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "GOOGLE_PRODUCT_CATEGORY_6"
        ]
      },
      "GoogleProductCategory5Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "GOOGLE_PRODUCT_CATEGORY_5": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "GOOGLE_PRODUCT_CATEGORY_5"
        ]
      },
      "GoogleProductCategory4Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "GOOGLE_PRODUCT_CATEGORY_4": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "GOOGLE_PRODUCT_CATEGORY_4"
        ]
      },
      "GoogleProductCategory3Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "GOOGLE_PRODUCT_CATEGORY_3": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "GOOGLE_PRODUCT_CATEGORY_3"
        ]
      },
      "GoogleProductCategory2Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "GOOGLE_PRODUCT_CATEGORY_2": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "GOOGLE_PRODUCT_CATEGORY_2"
        ]
      },
      "GoogleProductCategory1Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "GOOGLE_PRODUCT_CATEGORY_1": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "GOOGLE_PRODUCT_CATEGORY_1"
        ]
      },
      "GoogleProductCategory0Filter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "GOOGLE_PRODUCT_CATEGORY_0": {
            "type": "object",
            "$ref": "#/components/schemas/CatalogsProductGroupMultipleStringListCriteria"
          }
        },
        "required": [
          "GOOGLE_PRODUCT_CATEGORY_0"
        ]
      },
      "ConversionAttributionWindowDays": {
        "type": "integer",
        "enum": [
          1,
          7,
          30,
          60
        ]
      },
      "BulkReportingJobStatus": {
        "type": "string",
        "description": "Possible status for a bulk reporting job",
        "example": "FINISHED",
        "enum": [
          "DOES_NOT_EXIST",
          "FINISHED",
          "IN_PROGRESS",
          "EXPIRED",
          "FAILED",
          "CANCELLED"
        ]
      },
      "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": "The type of the user event. Please use the right event_name otherwise the event won’t be accepted and show up correctly in reports. <li><code>add_to_cart</code> <li><code>checkout</code> <li><code>custom</code> <li><code>lead</code> <li><code>page_visit</code> <li><code>search</code> <li><code>signup</code> <li><code>view_category</code> <li><code>watch_video</code>",
                  "type": "string",
                  "example": "checkout"
                },
                "action_source": {
                  "description": "The source indicating where the conversion event occurred. <li><code>app_android</code> <li><code>app_ios</code> <li><code>web</code> <li><code>offline</code>",
                  "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://example.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 ‘ss-shopify’",
                  "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": "425325.89",
                      "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": [
                        "my_product_id_1",
                        "my_product_id_2"
                      ]
                    },
                    "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": {
                          "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).",
                            "example": "1325.12",
                            "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",
                            "example": 5
                          }
                        }
                      }
                    },
                    "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": 2
                    },
                    "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"
                    },
                    "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. Values should be comma separated. Please follow the <a href=\"https://help.pinterest.com/en/business/article/limited-data-processing\" target=\"_blank\">Help Center</a> and <a href=\"https://developers.pinterest.com/docs/conversions/conversion-management/#Understanding%20Limited%20Data%20Processing\" target=\"_blank\">dev site</a> for specific opt_out_type set up.",
                      "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
                }
              },
              "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": [
          {
            "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.",
                "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.",
                "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",
                "example": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.87 Safari/537.36"
              }
            },
            "required": [
              "em"
            ]
          },
          {
            "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.",
                "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.",
                "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",
                "example": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.87 Safari/537.36"
              }
            },
            "required": [
              "hashed_maids"
            ]
          },
          {
            "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.",
                "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.",
                "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",
                "example": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.87 Safari/537.36"
              }
            },
            "required": [
              "client_ip_address",
              "client_user_agent"
            ]
          }
        ],
        "properties": {
          "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.",
            "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.",
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "0d248e82c62c9386878327d491c762a002152d42ab2c391a31c44d9f62675ddf"
            ]
          },
          "db": {
            "description": "Sha256 hashes of user's date of birthday, given as year, month, and day.",
            "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.",
            "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.",
            "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).",
            "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).",
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "49a6d05b8e4b516656e464271d9dd38d0a7e0142f7f49546f4dabd2720cafc34"
            ]
          },
          "zp": {
            "description": "Sha256 hashes of user's zipcode, only digits. User residency zipcode (mostly billing).",
            "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.",
            "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.",
            "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
          }
        }
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
                }
              }
            }
          }
        }
      },
      "EntityStatus": {
        "type": "string",
        "description": "Entity status",
        "example": "ACTIVE",
        "enum": [
          "ACTIVE",
          "PAUSED",
          "ARCHIVED"
        ]
      },
      "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
          }
        }
      },
      "Granularity": {
        "type": "string",
        "enum": [
          "TOTAL",
          "DAY",
          "HOUR",
          "WEEK",
          "MONTH"
        ]
      },
      "ItemAttributes": {
        "type": "object",
        "allOf": [
          {
            "properties": {
              "additional_image_link": {
                "description": "<p><= 2000 characters</p>\n<p>The links to additional images for your product. Up to ten\nadditional images can be used to show a product from different angles\nor 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>\n<p>The link to the main product images. Images should be at least\n75x75 pixels to avoid errors. Use the additional_image_link field to add\nmore images of your product. The URL of your image_link must be accessible\nby the Pinterest user-agent, and send the accurate images. Please make\nsure there are no template or placeholder images at the link. Must start\nwith http:// or https://.</p>",
                "example": [
                  "https://scene.example.com/image/image.jpg"
                ],
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": "string"
                }
              }
            }
          },
          {
            "$ref": "#/components/schemas/UpdatableItemAttributes"
          }
        ]
      },
      "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—do 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 “adult”. 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): ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, or ‘adult’.",
            "example": "newborn",
            "type": "string",
            "nullable": true
          },
          "availability": {
            "description": "The availability of the product. Must be one of the following values (upper or lowercased): ‘in stock’, ‘out of stock’, ‘preorder’.",
            "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’s Denim",
            "type": "string",
            "nullable": true
          },
          "checkout_enabled": {
            "description": "Set this attribute to FALSE to indicate items that should be excluded from the Pinterest Checkout program. Note, this product is currently being tested and your account must be enrolled. Please contact your Account Manager or contact us for more information.",
            "example": false,
            "type": "boolean",
            "nullable": 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): ‘new’, ‘used’, or ‘refurbished’.",
            "example": "new",
            "type": "string",
            "nullable": true
          },
          "custom_label_0": {
            "description": "<p><= 1000 characters</p>\n<p>Custom grouping of products.</p>",
            "example": "Best sellers",
            "type": "string",
            "nullable": true
          },
          "custom_label_1": {
            "description": "<p><= 1000 characters</p>\n<p>Custom grouping of products.</p>",
            "example": "Summer promotion",
            "type": "string",
            "nullable": true
          },
          "custom_label_2": {
            "description": "<p><= 1000 characters</p>\n<p>Custom grouping of products.</p>",
            "example": "Winter sales",
            "type": "string",
            "nullable": true
          },
          "custom_label_3": {
            "description": "<p><= 1000 characters</p>\n<p>Custom grouping of products.</p>",
            "example": "Woman dress",
            "type": "string",
            "nullable": true
          },
          "custom_label_4": {
            "description": "<p><= 1000 characters</p>\n<p>Custom grouping of products.</p>",
            "example": "Man hat",
            "type": "string",
            "nullable": true
          },
          "description": {
            "description": "<p><= 10000 characters</p>\n<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): ‘male’, ‘female’, or ‘unisex’.",
            "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,
            "type": "integer",
            "nullable": true
          },
          "id": {
            "description": "<p><= 127 characters</p>\n<p>The user-created unique ID that represents the product. Only\nUnicode characters are accepted.</p>",
            "example": "DS0294-L",
            "type": "string",
            "deprecated": true
          },
          "item_group_id": {
            "description": "<p><= 127 characters</p>\n<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>\n<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 “ > “. The > must be\nwrapped by spaces. We do not recognize any other delimiters such as comma\nor pipe.</p>",
            "example": "Clothing > Women’s > 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’s sizing system in which you are submitting your product. Must be one of the following values (upper or lowercased): ‘US’, ‘UK’, ‘EU’, ‘DE’, ‘FR’, ‘JP’, ‘CN’, ‘IT’, ‘BR’, ‘MEX’, or ‘AU’.",
            "example": "US",
            "type": "string",
            "nullable": true
          },
          "size_type": {
            "description": "Additional description for the size. Must be one of the following values (upper or lowercased): ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, or ‘maternity’.",
            "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>\n<p>The name of the product.</p>",
            "example": "Women’s 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"
            }
          }
        }
      },
      "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"
          }
        }
      },
      "ItemBatchRecord": {
        "type": "object",
        "description": "Object describing an item batch record",
        "oneOf": [
          {
            "$ref": "#/components/schemas/ItemCreateBatchRecord"
          },
          {
            "$ref": "#/components/schemas/ItemDeleteDiscontinuedBatchRecord"
          },
          {
            "$ref": "#/components/schemas/ItemUpdateBatchRecord"
          }
        ]
      },
      "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/ItemAttributes"
          }
        }
      },
      "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"
          }
        }
      },
      "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": {
              "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",
                "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"
              ]
            }
          }
        }
      },
      "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.\nA 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": {
              "item_id": {
                "description": "The catalog item id in the merchant namespace",
                "example": "DS0294-M",
                "type": "string"
              },
              "attributes": {
                "$ref": "#/components/schemas/ItemAttributes"
              }
            }
          },
          {
            "type": "object",
            "properties": {
              "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"
              }
            }
          }
        ]
      },
      "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"
          }
        }
      },
      "KeywordsCommon": {
        "type": "object",
        "properties": {
          "bid": {
            "type": "integer",
            "description": "Keyword custom bid in microcurrency - null if inherited from parent ad group.",
            "example": 200000,
            "nullable": true
          },
          "match_type": {
            "$ref": "#/components/schemas/MatchTypeResponse"
          },
          "value": {
            "type": "string",
            "description": "Keyword value (120 chars max)."
          }
        },
        "required": [
          "match_type",
          "value"
        ]
      },
      "KeywordError": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/Keyword"
          },
          "error_messages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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"
        ]
      },
      "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",
            "minimum": 1,
            "description": "Keyword custom bid in microcurrency - null if inherited from parent ad group.",
            "example": 200000,
            "nullable": true,
            "title": "bid"
          }
        },
        "required": [
          "id"
        ]
      },
      "KeywordUpdateBody": {
        "type": "object",
        "properties": {
          "keywords": {
            "description": "Keywords to update. Object array. Each object has 3 possible fields:<br>1. \"id\": (required) keyword ID<br>2. \"archived\": boolean. Should keyword be archived?<br>3. \"bid\": number<br>For example: [{\"id\":\"2886610576653\", \"archived\": false, \"bid\": 20000}, {\"id\":\"2886610576654\",  \"archived\": true, \"bid\": 20000}, ...]",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/KeywordUpdate"
            },
            "title": "keywords"
          }
        },
        "required": [
          "keywords"
        ]
      },
      "KeywordMetrics": {
        "description": "Keyword metrics JSON",
        "title": "KeywordMetrics",
        "type": "object",
        "properties": {
          "avg_cpc_in_micro_currency": {
            "example": 100000,
            "title": "avg_cpc_in_micro_currency",
            "description": "Average cost per click",
            "type": "number"
          },
          "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"
          }
        }
      },
      "KeywordsMetricsArrayResponse": {
        "type": "object",
        "title": "KeywordMetricsArrayResponse",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/KeywordMetricsResponse"
            }
          }
        }
      },
      "KeywordsResponse": {
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/KeywordError"
            }
          },
          "keywords": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Keyword"
            }
          }
        }
      },
      "Language": {
        "type": "string",
        "description": "Language code, which is among the offical 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"
        ]
      },
      "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"
          }
        }
      },
      "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
        ]
      },
      "MediaUpload": {
        "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"
        ]
      },
      "Metrics": {
        "description": "The metric name and daily value for each requested metric",
        "type": "object",
        "additionalProperties": {
          "type": "number"
        },
        "example": {
          "SAVE": 20,
          "SAVE_RATE": 0.18,
          "IMPRESSION": 240,
          "OUTBOUND_CLICK": 200,
          "PIN_CLICK": 37,
          "VIDEO_10S_VIEW": 2,
          "VIDEO_V50_WATCH_TIME": 10031,
          "QUARTILE_95_PERCENT_VIEW": 8,
          "VIDEO_AVG_WATCH_TIME": 2507.75,
          "VIDEO_START": 2,
          "VIDEO_MRC_VIEW": 2
        }
      },
      "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": "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"
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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",
          "SALE_PRICE_EFFECTIVE_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",
          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"
          }
        },
        "properties": {
          "grant_type": {
            "type": "string",
            "enum": [
              "authorization_code",
              "refresh_token"
            ]
          }
        },
        "required": [
          "grant_type"
        ]
      },
      "OauthAccessTokenRequestRefresh": {
        "title": "refresh_token",
        "description": "A request to exchange a refresh token for a new access token.",
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/OauthAccessTokenRequest"
          },
          {
            "type": "object",
            "properties": {
              "refresh_token": {
                "type": "string"
              },
              "scope": {
                "type": "string"
              }
            },
            "required": [
              "refresh_token"
            ]
          }
        ]
      },
      "OauthAccessTokenRequestCode": {
        "title": "authorization_code",
        "description": "A request to exchange an authorization code for an access token.",
        "allOf": [
          {
            "$ref": "#/components/schemas/OauthAccessTokenRequest"
          },
          {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "redirect_uri": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "redirect_uri"
            ]
          }
        ]
      },
      "OauthAccessTokenResponse": {
        "title": "OAuth access token response",
        "description": "A successful OAuth access token response.",
        "type": "object",
        "properties": {
          "response_type": {
            "type": "string",
            "enum": [
              "authorization_code",
              "refresh_token"
            ]
          },
          "access_token": {
            "type": "string"
          },
          "token_type": {
            "type": "string",
            "default": "bearer"
          },
          "expires_in": {
            "type": "integer"
          },
          "scope": {
            "type": "string"
          }
        },
        "discriminator": {
          "propertyName": "response_type",
          "mapping": {
            "authorization_code": "#/components/schemas/OauthAccessTokenResponseCode",
            "refresh_token": "#/components/schemas/OauthAccessTokenResponseRefresh",
            "integration_refresh": "#/components/schemas/OauthAccessTokenResponseIntegrationRefresh"
          }
        },
        "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": [
          {
            "$ref": "#/components/schemas/OauthAccessTokenResponse"
          },
          {
            "type": "object",
            "properties": {
              "refresh_token": {
                "type": "string"
              },
              "refresh_token_expires_in": {
                "type": "integer"
              }
            },
            "required": [
              "refresh_token",
              "refresh_token_expires_in"
            ]
          }
        ]
      },
      "OauthAccessTokenResponseRefresh": {
        "title": "OAuth access token response",
        "description": "A successful OAuth access token response for the refresh token flow.",
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/OauthAccessTokenResponse"
          }
        ]
      },
      "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": [
          {
            "$ref": "#/components/schemas/OauthAccessTokenResponse"
          },
          {
            "type": "object",
            "properties": {
              "refresh_token": {
                "type": "string"
              },
              "refresh_token_expires_in": {
                "type": "integer"
              }
            },
            "required": [
              "refresh_token",
              "refresh_token_expires_in"
            ]
          }
        ]
      },
      "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": "Ad group is ROAS optimized",
                "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"
              }
            },
            "type": "object"
          },
          "frequency_goal_metadata": {
            "properties": {
              "frequency": {
                "type": "integer"
              },
              "timerange": {
                "type": "string",
                "description": "User entity counts time range",
                "example": "DAY",
                "enum": [
                  "THIRTY_DAY",
                  "DAY",
                  "SEVEN_DAY",
                  "TWENTY_MINUTE",
                  "TEN_MINUTE"
                ]
              }
            },
            "type": "object"
          },
          "scrollup_goal_metadata": {
            "properties": {
              "scrollup_goal_value_in_micro_currency": {
                "pattern": "^[0-9]+$",
                "type": "string",
                "nullable": true
              }
            },
            "type": "object"
          }
        }
      },
      "OrderLineStatus": {
        "description": "Order Line Status",
        "enum": [
          "ACTIVE",
          "PAUSED",
          "DELETED"
        ],
        "example": "ACTIVE",
        "title": "OrderLineStatus",
        "type": "string"
      },
      "OrderLinePaidType": {
        "description": "Order Line Paid Type",
        "enum": [
          "PAID",
          "BONUS",
          "MAKE_GOOD",
          "TEST"
        ],
        "example": "PAID",
        "title": "OrderLinePaidType",
        "type": "string"
      },
      "OrderLineSingleResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/OrderLineResponse",
            "type": "object"
          }
        },
        "title": "OrderLineSingleResponse"
      },
      "OrderLinesArrayResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OrderLines"
            }
          }
        },
        "title": "OrderLinesArrayResponse"
      },
      "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"
      },
      "OrderLineError": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/OrderLine",
            "type": "object"
          },
          "error_messages": {
            "items": {
              "type": "string"
            },
            "title": "error_messages",
            "type": "array"
          }
        },
        "title": "OrderLineError",
        "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"
      },
      "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"
          },
          "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"
          }
        }
      },
      "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"
        ]
      },
      "PlacementGroupType": {
        "type": "string",
        "description": "Campaign placement group type",
        "example": "ALL",
        "enum": [
          "ALL",
          "SEARCH",
          "BROWSE",
          "OTHER"
        ]
      },
      "Pin": {
        "title": "Pin",
        "description": "Pin",
        "type": "object",
        "nullable": true,
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "example": "813744226420795884",
            "pattern": "^\\d+$"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "example": "2020-01-01T20:10:40-00:00"
          },
          "link": {
            "type": "string",
            "nullable": true,
            "example": "https://www.pinterest.com/",
            "maxLength": 2048
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "dominant_color": {
            "type": "string",
            "nullable": true,
            "description": "Dominant pin color. Hex number, e.g. \\\"#6E7874\\\".",
            "example": "#6E7874"
          },
          "alt_text": {
            "type": "string",
            "nullable": true,
            "maxLength": 500
          },
          "creative_type": {
            "readOnly": true,
            "nullable": true,
            "type": "string",
            "allOf": [
              {
                "type": "string",
                "description": "Ad creative type enum.",
                "enum": [
                  "REGULAR",
                  "VIDEO",
                  "CAROUSEL",
                  "MAX_VIDEO",
                  "SHOP_THE_PIN",
                  "IDEA"
                ],
                "example": "REGULAR",
                "title": "Creative Type"
              }
            ]
          },
          "board_id": {
            "description": "The board to which this Pin belongs.",
            "type": "string",
            "pattern": "^\\d+$"
          },
          "board_section_id": {
            "description": "The board section to which this Pin belongs.",
            "type": "string",
            "pattern": "^\\d+$",
            "nullable": true
          },
          "board_owner": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BoardOwner"
              }
            ],
            "type": "object",
            "readOnly": true
          },
          "media": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PinMedia"
              }
            ],
            "type": "object",
            "readOnly": true
          },
          "media_source": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PinMediaSource"
              }
            ],
            "type": "object",
            "writeOnly": true
          },
          "parent_pin_id": {
            "description": "The source pin id if this pin was saved from another pin. <a href=\"https://help.pinterest.com/article/save-pins-on-pinterest\">Learn more</a>.",
            "type": "string",
            "pattern": "^\\d+$",
            "nullable": true
          }
        }
      },
      "PinCreate": {
        "title": "PinCreate",
        "description": "Pin",
        "type": "object",
        "nullable": true,
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "example": "813744226420795884",
            "pattern": "^\\d+$"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "example": "2020-01-01T20:10:40-00:00"
          },
          "link": {
            "type": "string",
            "nullable": true,
            "example": "https://www.pinterest.com/",
            "maxLength": 2048
          },
          "title": {
            "type": "string",
            "nullable": true,
            "maxLength": 100
          },
          "description": {
            "type": "string",
            "nullable": true,
            "maxLength": 500
          },
          "dominant_color": {
            "type": "string",
            "nullable": true,
            "description": "Dominant pin color. Hex number, e.g. \\\"#6E7874\\\".",
            "example": "#6E7874"
          },
          "alt_text": {
            "type": "string",
            "nullable": true,
            "maxLength": 500
          },
          "board_id": {
            "description": "The board to which this Pin belongs.",
            "type": "string",
            "pattern": "^\\d+$"
          },
          "board_section_id": {
            "description": "The board section to which this Pin belongs.",
            "type": "string",
            "pattern": "^\\d+$",
            "nullable": true
          },
          "board_owner": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BoardOwner"
              }
            ],
            "type": "object",
            "readOnly": true
          },
          "media": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PinMedia"
              }
            ],
            "type": "object",
            "readOnly": true
          },
          "media_source": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PinMediaSource"
              }
            ],
            "type": "object",
            "writeOnly": true
          },
          "parent_pin_id": {
            "description": "The source pin id if this pin was saved from another pin. <a href=\"https://help.pinterest.com/article/save-pins-on-pinterest\">Learn more</a>.",
            "type": "string",
            "pattern": "^\\d+$",
            "nullable": true
          }
        }
      },
      "PinUpdate": {
        "title": "PinUpdate",
        "description": "Pin fields for updates",
        "type": "object",
        "nullable": true,
        "properties": {
          "alt_text": {
            "type": "string",
            "nullable": true,
            "description": "Pin's alternative text.",
            "maxLength": 500
          },
          "board_id": {
            "type": "string",
            "nullable": true,
            "description": "The id of the board to move the Pin onto.",
            "pattern": "^\\d+$"
          },
          "board_section_id": {
            "type": "string",
            "nullable": true,
            "description": "<a href=\"https://help.pinterest.com/en/article/create-a-board-section\">Board section</a> ID.",
            "pattern": "^\\d+$"
          },
          "description": {
            "type": "string",
            "nullable": true,
            "description": "Pin description - 500 characters maximum.",
            "maxLength": 500
          },
          "link": {
            "type": "string",
            "nullable": true,
            "description": "URL viewer is taken to when they click pin.",
            "example": "https://www.pinterest.com/",
            "maxLength": 2048
          },
          "title": {
            "type": "string",
            "nullable": true,
            "description": "The native pin title that creators explicitly prefer to display.",
            "maxLength": 100
          },
          "carousel_slots": {
            "type": "array",
            "description": "Carousel Pin slots data.",
            "items": {
              "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."
                }
              }
            }
          }
        }
      },
      "PinMedia": {
        "title": "Pin media",
        "type": "object",
        "description": "Pin media objects.",
        "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"
          }
        },
        "properties": {
          "media_type": {
            "type": "string"
          }
        }
      },
      "PinMediaMetadata": {
        "type": "object",
        "anyOf": [
          {
            "$ref": "#/components/schemas/ImageMetadata"
          },
          {
            "$ref": "#/components/schemas/VideoMetadata"
          }
        ]
      },
      "PinMediaWithImage": {
        "title": "image",
        "description": "Pin with image.",
        "allOf": [
          {
            "type": "object",
            "properties": {
              "images": {
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/ImageDetails"
                }
              }
            }
          },
          {
            "$ref": "#/components/schemas/PinMedia"
          }
        ],
        "example": {
          "media_type": "image",
          "images": {
            "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"
            },
            "orig": {
              "width": 560,
              "height": 560,
              "url": "https://i.pinimg.com/originals/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
            }
          }
        }
      },
      "PinMediaWithImages": {
        "title": "Images",
        "description": "Pin with multiple images.",
        "allOf": [
          {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ImageMetadata"
                }
              }
            }
          },
          {
            "$ref": "#/components/schemas/PinMedia"
          }
        ]
      },
      "PinMediaWithVideo": {
        "title": "video",
        "description": "Pin with video.",
        "allOf": [
          {
            "type": "object",
            "properties": {
              "images": {
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/ImageDetails"
                }
              },
              "cover_image_url": {
                "type": "string"
              },
              "duration": {
                "type": "number",
                "description": "Duration (in milliseconds)"
              },
              "height": {
                "type": "integer",
                "description": "Height (in pixels)"
              },
              "width": {
                "type": "integer",
                "description": "Width (in pixels)"
              }
            }
          },
          {
            "$ref": "#/components/schemas/PinMedia"
          }
        ],
        "example": {
          "media_type": "video",
          "images": {
            "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"
            },
            "orig": {
              "width": 560,
              "height": 560,
              "url": "https://i.pinimg.com/originals/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
            }
          },
          "cover_image_url": "https://i.pinimg.com/videos/thumbnails/originals/a8/b9/38/a8b938b1dacc523054a6bac201e9f1d2.0000001.jpg",
          "duration": 14000,
          "height": 1064,
          "width": 1280
        }
      },
      "PinMediaWithVideos": {
        "title": "Videos",
        "description": "Pin with multiple videos.",
        "allOf": [
          {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/VideoMetadata"
                }
              }
            }
          },
          {
            "$ref": "#/components/schemas/PinMedia"
          }
        ]
      },
      "PinMediaWithImageAndVideo": {
        "title": "Video and image",
        "description": "Pin with a mix of images and videos.",
        "allOf": [
          {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PinMediaMetadata"
                }
              }
            }
          },
          {
            "$ref": "#/components/schemas/PinMedia"
          }
        ]
      },
      "PinMediaSource": {
        "title": "Pin media source",
        "description": "Pin media source.",
        "oneOf": [
          {
            "$ref": "#/components/schemas/PinMediaSourceImageBase64"
          },
          {
            "$ref": "#/components/schemas/PinMediaSourceImageURL"
          },
          {
            "$ref": "#/components/schemas/PinMediaSourceVideoID"
          },
          {
            "$ref": "#/components/schemas/PinMediaSourceImagesBase64"
          },
          {
            "$ref": "#/components/schemas/PinMediaSourceImagesURL"
          }
        ],
        "discriminator": {
          "propertyName": "source_type",
          "mapping": {
            "multiple_image_base64": "#/components/schemas/PinMediaSourceImagesBase64",
            "image_base64": "#/components/schemas/PinMediaSourceImageBase64",
            "multiple_image_urls": "#/components/schemas/PinMediaSourceImagesURL",
            "image_url": "#/components/schemas/PinMediaSourceImageURL",
            "video_id": "#/components/schemas/PinMediaSourceVideoID"
          }
        }
      },
      "PinMediaSourceImagesBase64": {
        "title": "Images Base64",
        "description": "Multiple Base64-encoded images media source",
        "additionalProperties": false,
        "properties": {
          "source_type": {
            "type": "string",
            "enum": [
              "multiple_image_base64"
            ]
          },
          "items": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "title": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "link": {
                  "type": "string",
                  "description": "Destination link for the image."
                },
                "content_type": {
                  "type": "string",
                  "enum": [
                    "image/jpeg",
                    "image/png"
                  ]
                },
                "data": {
                  "type": "string",
                  "description": "Image to upload as base64 string.",
                  "pattern": "[a-zA-Z0-9+\\/=]+"
                }
              },
              "required": [
                "data",
                "content_type"
              ],
              "type": "object"
            },
            "minItems": 2,
            "maxItems": 5,
            "description": "Array with image objects.",
            "type": "array"
          },
          "index": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "PinMediaSourceImageBase64": {
        "title": "Image Base64",
        "description": "Base64-encoded image media source",
        "type": "object",
        "properties": {
          "source_type": {
            "type": "string",
            "enum": [
              "image_base64"
            ]
          },
          "content_type": {
            "type": "string",
            "enum": [
              "image/jpeg",
              "image/png"
            ]
          },
          "data": {
            "type": "string",
            "pattern": "[a-zA-Z0-9+\\/=]+"
          },
          "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
          }
        },
        "required": [
          "source_type",
          "content_type",
          "data"
        ]
      },
      "PinMediaSourceImagesURL": {
        "title": "Images urls",
        "description": "Multiple images urls-based media source",
        "additionalProperties": false,
        "properties": {
          "source_type": {
            "type": "string",
            "enum": [
              "multiple_image_urls"
            ]
          },
          "items": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "title": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "link": {
                  "type": "string",
                  "description": "Destination link for the image."
                },
                "url": {
                  "description": "URL of image to upload.",
                  "type": "string"
                }
              },
              "required": [
                "url"
              ],
              "type": "object"
            },
            "minItems": 2,
            "maxItems": 5,
            "description": "Array with image objects.",
            "type": "array"
          },
          "index": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "PinMediaSourceImageURL": {
        "title": "Image URL",
        "description": "Image URL-based media source",
        "type": "object",
        "properties": {
          "source_type": {
            "type": "string",
            "enum": [
              "image_url"
            ]
          },
          "url": {
            "type": "string"
          },
          "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
          }
        },
        "required": [
          "source_type",
          "url"
        ]
      },
      "PinMediaSourceVideoID": {
        "title": "Video ID",
        "description": "Video ID-based media source",
        "type": "object",
        "properties": {
          "source_type": {
            "type": "string",
            "enum": [
              "video_id"
            ]
          },
          "cover_image_url": {
            "type": "string"
          },
          "media_id": {
            "type": "string",
            "pattern": "^\\d+$"
          },
          "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
          }
        },
        "required": [
          "source_type",
          "cover_image_url",
          "media_id"
        ]
      },
      "ImageDetails": {
        "title": "ImageDetails",
        "type": "object",
        "properties": {
          "width": {
            "type": "integer",
            "minimum": 100
          },
          "height": {
            "type": "integer",
            "minimum": 100,
            "nullable": true
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "height",
          "width",
          "url"
        ],
        "example": {
          "width": 400,
          "height": 300,
          "url": "https://i.pinimg.com/400x300/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
        }
      },
      "ImageMetadata": {
        "title": "Image metadata",
        "type": "object",
        "properties": {
          "item_type": {
            "type": "string"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "link": {
            "type": "string",
            "nullable": true
          },
          "images": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/ImageDetails"
            }
          }
        }
      },
      "VideoMetadata": {
        "title": "Video metadata",
        "type": "object",
        "properties": {
          "item_type": {
            "type": "string"
          },
          "cover_image_url": {
            "type": "string"
          },
          "duration": {
            "type": "number",
            "description": "Duration (in milliseconds)"
          },
          "height": {
            "type": "integer",
            "description": "Height (in pixels)"
          },
          "width": {
            "type": "integer",
            "description": "Width (in pixels)"
          }
        }
      },
      "PinPromotionSummaryStatus": {
        "type": "string",
        "description": "Summary status for pin promotions",
        "example": "APPROVED",
        "enum": [
          "APPROVED",
          "PAUSED",
          "PENDING",
          "REJECTED",
          "ADVERTISER_DISABLED",
          "ARCHIVED"
        ]
      },
      "CreativeType": {
        "type": "string",
        "description": "Ad creative type enum",
        "enum": [
          "REGULAR",
          "VIDEO",
          "SHOPPING",
          "CAROUSEL",
          "MAX_VIDEO",
          "SHOP_THE_PIN",
          "IDEA",
          "QUIZ"
        ],
        "example": "REGULAR",
        "title": "CreativeType"
      },
      "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",
            "nullable": true,
            "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": "number"
          },
          "partner_refresh_token_expiry": {
            "type": "number"
          },
          "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"
          }
        }
      },
      "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
          }
        }
      },
      "ProductGroupSummaryStatus": {
        "type": "string",
        "description": "Summary status for product group",
        "example": "RUNNING",
        "enum": [
          "RUNNING",
          "PAUSED",
          "EXCLUDED",
          "ARCHIVED"
        ]
      },
      "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"
          }
        },
        "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"
      },
      "ProductGroupPromotionResponseItem": {
        "type": "object",
        "title": "ProductGroupPromotionResponseItem",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ProductGroupPromotion"
          },
          "exceptions": {
            "nullable": true,
            "items": {
              "nullable": true,
              "$ref": "#/components/schemas/Exception"
            }
          }
        }
      },
      "ProductGroupPromotionResponse": {
        "type": "object",
        "title": "ProductGroupPromotionResponse",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductGroupPromotionResponseItem"
            }
          }
        }
      },
      "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"
      },
      "ReportingColumnAsync": {
        "type": "string",
        "description": "Reporting columns",
        "example": "SPEND_IN_MICRO_DOLLAR",
        "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",
          "COST_PER_OUTBOUND_CLICK",
          "CAMPAIGN_NAME",
          "CAMPAIGN_STATUS",
          "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",
          "CPM_IN_MICRO_DOLLAR",
          "CPM_IN_DOLLAR",
          "AD_GROUP_NAME",
          "AD_GROUP_STATUS",
          "AD_GROUP_ENTITY_STATUS",
          "PRODUCT_GROUP_ID",
          "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",
          "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",
          "CAMPAIGN_DAILY_SPEND_CAP",
          "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_LEAD",
          "TOTAL_APP_INSTALL",
          "TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR",
          "TOTAL_CHECKOUT_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",
          "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",
          "VIDEO_LENGTH",
          "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_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_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"
        ]
      },
      "ObjectiveType": {
        "type": "string",
        "description": "Campaign objective type. [\"WEB_SESSIONS\"] in BETA.",
        "enum": [
          "AWARENESS",
          "CONSIDERATION",
          "VIDEO_VIEW",
          "WEB_CONVERSION",
          "CATALOG_SALES",
          "WEB_SESSIONS"
        ]
      },
      "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
          }
        }
      },
      "TargetingOptionResponse": {
        "title": "TargetingOptionResponse",
        "type": "array",
        "nullable": true,
        "items": {
          "type": "object",
          "example": {
            "36313": "Australia: Moreton Bay - North",
            "124735": "Canada: North Battleford"
          }
        }
      },
      "TargetingTypeFilter": {
        "type": "object",
        "properties": {
          "targeting_types": {
            "type": "array",
            "description": "List of targeting types",
            "items": {
              "$ref": "#/components/schemas/AdsAnalyticsTargetingType"
            },
            "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"
                    ],
                    "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": {
            "description": "Level of the reporting request",
            "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"
            ],
            "example": "PIN_PROMOTION",
            "type": "string"
          },
          "report_format": {
            "description": "Format of reporting data",
            "enum": [
              "JSON",
              "CSV"
            ],
            "example": "JSON",
            "type": "string"
          },
          "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",
                "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",
                "CPC_IN_MICRO_CURRENCY",
                "CPW_IN_MICRO_DOLLAR",
                "CPW_IN_DOLLAR",
                "COST_PER_OUTBOUND_CLICK",
                "AD_ONLY_PIN",
                "CAMPAIGN_NAME",
                "CAMPAIGN_STATUS",
                "DATE",
                "BUDGET_IN_DOLLAR",
                "AVAILABLE_BUDGET_IN_DOLLAR",
                "TARGETING_TYPE",
                "TARGETING_VALUE",
                "TARGETING_VALUE_NAME",
                "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",
                "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",
                "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",
                "ITEM_ID",
                "PRODUCT_ITEM_ID",
                "INTERNAL_PRODUCT_ITEM_ID",
                "ORDER_LINE_ID",
                "ORDER_LINE_NAME",
                "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_FREQUENCY",
                "TOTAL_OUTBOUND_CLICK",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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_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_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_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_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_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_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_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_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",
                "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_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_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_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_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",
                "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",
                "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",
                "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",
                "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",
                "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",
                "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_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",
                "VIDEO_LENGTH",
                "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",
                "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",
                "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",
                "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",
                "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_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"
              ]
            },
            "type": "array"
          },
          "granularity": {
            "description": "Granularity",
            "enum": [
              "TOTAL",
              "DAY",
              "HOUR",
              "WEEK",
              "MONTH"
            ],
            "example": "DAY",
            "type": "string"
          },
          "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": {
              "description": "Custom Column ID",
              "example": "123456789",
              "type": "string"
            },
            "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"
      },
      "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"
                  ]
                }
              }
            }
          }
        }
      },
      "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"
            }
          }
        }
      },
      "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",
                "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. If the GEO field is missing, the default behavior in terms of ad delivery is that **No geos will be selected**.",
            "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 missing, the default behavior in terms of ad delivery is that **All languages will be target, only english non-sublanguage will be 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. If the LOCATION field is missing, the default behavior in terms of ad delivery is that **Selects default country if not specified (US) and all regions within that country**.",
            "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",
              "properties": {
                "lookback_window": {
                  "type": "integer"
                },
                "tag_types": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  }
                },
                "exclusion_window": {
                  "type": "integer"
                }
              }
            }
          },
          "TARGETING_STRATEGY": {
            "type": "array",
            "nullable": true,
            "description": "",
            "items": {
              "enum": [
                "CHOOSE_YOUR_OWN",
                "FIND_NEW_CUSTOMERS",
                "RECONNECT_WITH_USERS"
              ]
            }
          }
        }
      },
      "TermsSuggestedResponse": {
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "UserListType": {
        "description": "User list type",
        "enum": [
          "EMAIL",
          "IDFA",
          "MAID",
          "LR_ID",
          "DLX_ID",
          "HASHED_PINNER_ID"
        ],
        "example": "EMAIL",
        "title": "UserListType",
        "type": "string"
      },
      "UserListOperationType": {
        "description": "User list operation type (add or remove)",
        "enum": [
          "ADD",
          "REMOVE"
        ],
        "example": "REMOVE",
        "title": "UserListOperationType",
        "type": "string"
      },
      "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"
          }
        }
      },
      "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"
      },
      "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"
            ]
          }
        }
      },
      "ConversionTagListResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ConversionTagResponse"
            }
          }
        }
      },
      "ConversionTagResponse": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ConversionTagCommon"
          }
        ],
        "title": "ConversionTagResponse"
      },
      "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
          }
        },
        "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"
      },
      "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
          }
        }
      },
      "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"
      }
    },
    "parameters": {
      "path_ad_id": {
        "name": "ad_id",
        "description": "Unique identifier of an ad.",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "pattern": "^\\d+$",
          "maxLength": 18
        }
      },
      "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_audience_id": {
        "name": "audience_id",
        "description": "Unique identifier of an audience",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "pattern": "^\\d+$",
          "maxLength": 18
        }
      },
      "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_interest_id": {
        "name": "interest_id",
        "description": "Unique identifier of an interest.",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "pattern": "^\\d+$",
          "maxLength": 18
        }
      },
      "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_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"
        }
      },
      "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": "595953100599279259-66753b9bb65c46c49bd8503b27fecf9e",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "path_catalogs_processing_result_id": {
        "description": "Unique identifier of a feed processing result",
        "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_external_business_id": {
        "name": "external_business_id",
        "description": "External business ID for the integration.",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "path_media_id": {
        "name": "media_id",
        "description": "Media identifier",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "pattern": "^\\d+$"
        }
      },
      "path_pin_id": {
        "name": "pin_id",
        "description": "Unique identifier of a Pin.",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "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_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_scope": {
        "name": "scope",
        "description": "Generated audience scope to request.",
        "in": "path",
        "required": true,
        "style": "simple",
        "schema": {
          "$ref": "#/components/schemas/AudienceDefinitionScope"
        }
      },
      "path_template_id": {
        "name": "template_id",
        "description": "Unique identifier of a template.",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "pattern": "^\\d+$",
          "maxLength": 18
        }
      },
      "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"
        }
      },
      "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"
      },
      "query_username": {
        "name": "username",
        "description": "Name of the user to be looked up.",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "pattern": "(?!^\\d+$)^.+$",
          "default": "me"
        }
      },
      "path_aggregated_pin_data": {
        "name": "aggregated_pin_data",
        "description": "Id of aggregated pin data",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "pattern": "^\\d+$"
        }
      },
      "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_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_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_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_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_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_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_client_id": {
        "name": "client_id",
        "description": "Client ID.",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "pattern": "^\\d+$",
          "maxLength": 18,
          "example": "1094834"
        },
        "style": "form"
      },
      "query_catalogs_feed_id": {
        "description": "Unique identifier of a feed",
        "in": "query",
        "required": true,
        "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": {
        "name": "item_ids",
        "in": "query",
        "description": "Catalogs Item ids",
        "example": [
          "CR123"
        ],
        "required": true,
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "query_catalogs_items_language": {
        "name": "language",
        "in": "query",
        "description": "Language for the Catalogs Items",
        "example": "EN",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "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",
              "CAMPAIGN_NAME",
              "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",
              "CPM_IN_MICRO_DOLLAR",
              "CPM_IN_DOLLAR",
              "AD_GROUP_ENTITY_STATUS",
              "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",
              "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",
              "CAMPAIGN_LIFETIME_SPEND_CAP",
              "CAMPAIGN_DAILY_SPEND_CAP",
              "TOTAL_PAGE_VISIT",
              "TOTAL_SIGNUP",
              "TOTAL_CHECKOUT",
              "TOTAL_CUSTOM",
              "TOTAL_LEAD",
              "TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR",
              "TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR",
              "PAGE_VISIT_COST_PER_ACTION",
              "PAGE_VISIT_ROAS",
              "CHECKOUT_ROAS",
              "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",
              "VIDEO_LENGTH",
              "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_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"
            ]
          },
          "type": "array"
        }
      },
      "query_conversion_attribution_click_window_days": {
        "name": "click_window_days",
        "in": "query",
        "schema": {
          "type": "integer",
          "enum": [
            1,
            7,
            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_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.",
        "schema": {
          "type": "integer",
          "enum": [
            1,
            7,
            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": [
            1,
            7,
            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_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_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"
            ]
          },
          "default": [
            "ACTIVE",
            "PAUSED"
          ]
        }
      },
      "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_feed_profile_id": {
        "in": "query",
        "name": "feed_profile_id",
        "description": "The feed profile id whose catalog product groups we want to return.",
        "required": false,
        "schema": {
          "pattern": "^\\d+$",
          "maxLength": 18,
          "type": "string"
        }
      },
      "query_filter_deleted": {
        "name": "filter_deleted",
        "description": "Filter out deleted tags.",
        "in": "query",
        "required": false,
        "schema": {
          "type": "boolean",
          "example": true,
          "default": false
        }
      },
      "query_comment_feed_type": {
        "name": "feed_type",
        "description": "Comment feed type.",
        "in": "query",
        "schema": {
          "type": "string",
          "enum": [
            "ranked",
            "recent"
          ],
          "default": "recent"
        }
      },
      "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_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_protected_pins": {
        "name": "include_protected_pins",
        "description": "Specify if return pins from protected boards",
        "required": false,
        "in": "query",
        "schema": {
          "type": "boolean",
          "default": false
        }
      },
      "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_oauth_signature": {
        "name": "oauth_signature",
        "description": "Oauth signature",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "example": "8209f"
        },
        "style": "form"
      },
      "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 href=\"/docs/redoc/#section/Match-type-(keyword).\">match type</a>",
        "in": "query",
        "name": "match_types",
        "required": false,
        "schema": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/MatchType"
          },
          "minItems": 1,
          "maxItems": 5
        }
      },
      "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_pin_filter": {
        "name": "pin_filter",
        "description": "Pin filter.",
        "required": false,
        "in": "query",
        "schema": {
          "type": "string",
          "enum": [
            "exclude_native",
            "exclude_repins"
          ]
        }
      },
      "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_search_query": {
        "description": "String keywords to search for audiences by.",
        "in": "query",
        "name": "search_query",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "query_start_index": {
        "description": "The starting index for returned list.",
        "in": "query",
        "name": "start_index",
        "required": false,
        "schema": {
          "type": "string",
          "pattern": "^\\d+$"
        }
      },
      "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_pin_analytics_metric_types": {
        "description": "Pin metric types to get data for, default is all.",
        "explode": false,
        "in": "query",
        "name": "metric_types",
        "required": true,
        "schema": {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "description": "Standard Pin metric types",
                "type": "string",
                "enum": [
                  "OUTBOUND_CLICK",
                  "PIN_CLICK",
                  "IMPRESSION",
                  "SAVE",
                  "SAVE_RATE"
                ]
              },
              {
                "description": "Video Pin metric types",
                "type": "string",
                "enum": [
                  "OUTBOUND_CLICK",
                  "IMPRESSION",
                  "SAVE",
                  "QUARTILE_95_PERCENT_VIEW",
                  "VIDEO_10S_VIEW",
                  "VIDEO_AVG_WATCH_TIME",
                  "VIDEO_MRC_VIEW",
                  "VIDEO_START",
                  "VIDEO_V50_WATCH_TIME"
                ]
              }
            ]
          }
        },
        "style": "form"
      },
      "query_order_by": {
        "description": "The audience field to order results by.",
        "in": "query",
        "name": "order_by",
        "required": false,
        "schema": {
          "$ref": "#/components/schemas/GetAudiencesOrderBy"
        }
      },
      "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",
            "PIN_FORMAT"
          ],
          "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_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_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_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_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_order": {
        "description": "The order in which to sort the items returned: “ASCENDING” or “DESCENDING”\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_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_tos_type": {
        "description": "Request type.",
        "explode": true,
        "in": "query",
        "name": "tos_type",
        "required": false,
        "schema": {
          "type": "string"
        },
        "style": "form"
      },
      "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/getting-started/pagination/'>Pagination</a> for more information.",
        "in": "query",
        "required": false,
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 250,
          "default": 25
        }
      },
      "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",
            "PRODUCT",
            "REGULAR",
            "VIDEO"
          ],
          "type": "string"
        }
      },
      "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_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_token_required": {
        "name": "token",
        "description": "Token returned from the post request creation call",
        "in": "query",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "query_include_shared_accounts": {
        "in": "query",
        "description": "Include shared ad accounts",
        "name": "include_shared_accounts",
        "required": false,
        "schema": {
          "type": "boolean",
          "default": true
        }
      },
      "query_timestamp": {
        "name": "timestamp",
        "description": "Timestamp",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "example": "1618338184277",
          "pattern": "\\d+"
        },
        "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_input_term": {
        "description": "Input term.",
        "in": "query",
        "name": "term",
        "example": "sports",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "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_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_report_type": {
        "name": "report_type",
        "description": "Report type.",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "enum": [
            "SYNC",
            "ASYNC"
          ]
        }
      },
      "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_targeting_types": {
        "name": "targeting_types",
        "description": "Targeting type breakdowns for the report. The reporting per targeting type <br> is independent from each other.",
        "required": true,
        "explode": false,
        "in": "query",
        "schema": {
          "items": {
            "$ref": "#/components/schemas/AdsAnalyticsTargetingType"
          },
          "maxItems": 15,
          "minItems": 1,
          "type": "array"
        }
      },
      "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_query": {
        "description": "Search query. Can contain pin description keywords or comma-separated pin IDs.",
        "in": "query",
        "name": "query",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "query_required_search_query": {
        "description": "Search query.",
        "in": "query",
        "example": "Plants",
        "name": "query",
        "required": true,
        "schema": {
          "pattern": "(?!^\\d+$)^.+$",
          "type": "string"
        }
      },
      "query_creative_types": {
        "in": "query",
        "name": "creative_types",
        "required": false,
        "description": "Pin creative types filter.",
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "example": "REGULAR",
            "enum": [
              "REGULAR",
              "VIDEO",
              "SHOPPING",
              "CAROUSEL",
              "MAX_VIDEO",
              "SHOP_THE_PIN",
              "IDEA"
            ]
          }
        }
      },
      "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_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_website": {
        "description": "Website with path or domain only",
        "in": "query",
        "name": "website",
        "required": true,
        "schema": {
          "type": "string",
          "example": "mysite.test"
        }
      }
    }
  }
}