# Ad Exchange Buyer API . pretargetingConfig

## Instance Methods

Deletes an existing pretargeting config.

Gets a specific pretargeting configuration

Inserts a new pretargeting configuration.

Retrieves a list of the authenticated user's pretargeting configurations.

Updates an existing pretargeting config. This method supports patch semantics.

Updates an existing pretargeting config.

### Method Details

`delete(accountId, configId)`

    Deletes an existing pretargeting config.

    Args:
      accountId: string, The account id to delete the pretargeting config for. (required)
      configId: string, The specific id of the configuration to delete. (required)

`get(accountId, configId)`

    Gets a specific pretargeting configuration

    Args:
      accountId: string, The account id to get the pretargeting config for. (required)
      configId: string, The specific id of the configuration to retrieve. (required)

    Returns:
      An object of the form:

        {
          "verticals": [ # Requests containing any of these vertical ids will match.
            "A String",
          ],
          "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.
            "A String",
          ],
          "videoPlayerSizes": [ # Video requests satisfying any of these player size constraints will match.
            {
              "minWidth": "A String", # The minimum player width in pixels. Leave this field blank to match any player width.
              "aspectRatio": "A String", # The type of aspect ratio. Leave this field blank to match all aspect ratios.
              "minHeight": "A String", # The minimum player height in pixels. Leave this field blank to match any player height.
            },
          ],
          "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests.
          "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.
            "A String",
          ],
          "configName": "A String", # The name of the config. Must be unique. Required for all requests.
          "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match.
            "A String",
          ],
          "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.
            "A String",
          ],
          "languages": [ # Request containing any of these language codes will match.
            "A String",
          ],
          "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.
            "A String",
          ],
          "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.
            "A String",
          ],
          "excludedPlacements": [ # Requests containing any of these placements will not match.
            {
              "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
              "type": "A String", # The type of the placement.
            },
          ],
          "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
          "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
            "A String",
          ],
          "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.
            "A String",
          ],
          "excludedUserLists": [ # Requests containing any of these users list ids will not match.
            "A String",
          ],
          "isActive": True or False, # Whether this config is active. Required for all requests.
          "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
            {
              "width": "A String", # Width in pixels.
              "height": "A String", # Height in pixels.
            },
          ],
          "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
          "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
            "A String",
          ],
          "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
            "A String",
          ],
          "userLists": [ # Requests containing any of these user list ids will match.
            "A String",
          ],
          "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
            "A String",
          ],
          "placements": [ # Requests containing any of these placements will match.
            {
              "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
              "type": "A String", # The type of the placement.
            },
          ],
        }

`insert(accountId, body)`

    Inserts a new pretargeting configuration.

    Args:
      accountId: string, The account id to insert the pretargeting config for. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "verticals": [ # Requests containing any of these vertical ids will match.
          "A String",
        ],
        "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.
          "A String",
        ],
        "videoPlayerSizes": [ # Video requests satisfying any of these player size constraints will match.
          {
            "minWidth": "A String", # The minimum player width in pixels. Leave this field blank to match any player width.
            "aspectRatio": "A String", # The type of aspect ratio. Leave this field blank to match all aspect ratios.
            "minHeight": "A String", # The minimum player height in pixels. Leave this field blank to match any player height.
          },
        ],
        "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests.
        "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.
          "A String",
        ],
        "configName": "A String", # The name of the config. Must be unique. Required for all requests.
        "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match.
          "A String",
        ],
        "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.
          "A String",
        ],
        "languages": [ # Request containing any of these language codes will match.
          "A String",
        ],
        "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.
          "A String",
        ],
        "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.
          "A String",
        ],
        "excludedPlacements": [ # Requests containing any of these placements will not match.
          {
            "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
            "type": "A String", # The type of the placement.
          },
        ],
        "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
        "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
          "A String",
        ],
        "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.
          "A String",
        ],
        "excludedUserLists": [ # Requests containing any of these users list ids will not match.
          "A String",
        ],
        "isActive": True or False, # Whether this config is active. Required for all requests.
        "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
          {
            "width": "A String", # Width in pixels.
            "height": "A String", # Height in pixels.
          },
        ],
        "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
        "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
          "A String",
        ],
        "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
          "A String",
        ],
        "userLists": [ # Requests containing any of these user list ids will match.
          "A String",
        ],
        "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
          "A String",
        ],
        "placements": [ # Requests containing any of these placements will match.
          {
            "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
            "type": "A String", # The type of the placement.
          },
        ],
      }

    Returns:
      An object of the form:

        {
          "verticals": [ # Requests containing any of these vertical ids will match.
            "A String",
          ],
          "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.
            "A String",
          ],
          "videoPlayerSizes": [ # Video requests satisfying any of these player size constraints will match.
            {
              "minWidth": "A String", # The minimum player width in pixels. Leave this field blank to match any player width.
              "aspectRatio": "A String", # The type of aspect ratio. Leave this field blank to match all aspect ratios.
              "minHeight": "A String", # The minimum player height in pixels. Leave this field blank to match any player height.
            },
          ],
          "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests.
          "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.
            "A String",
          ],
          "configName": "A String", # The name of the config. Must be unique. Required for all requests.
          "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match.
            "A String",
          ],
          "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.
            "A String",
          ],
          "languages": [ # Request containing any of these language codes will match.
            "A String",
          ],
          "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.
            "A String",
          ],
          "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.
            "A String",
          ],
          "excludedPlacements": [ # Requests containing any of these placements will not match.
            {
              "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
              "type": "A String", # The type of the placement.
            },
          ],
          "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
          "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
            "A String",
          ],
          "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.
            "A String",
          ],
          "excludedUserLists": [ # Requests containing any of these users list ids will not match.
            "A String",
          ],
          "isActive": True or False, # Whether this config is active. Required for all requests.
          "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
            {
              "width": "A String", # Width in pixels.
              "height": "A String", # Height in pixels.
            },
          ],
          "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
          "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
            "A String",
          ],
          "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
            "A String",
          ],
          "userLists": [ # Requests containing any of these user list ids will match.
            "A String",
          ],
          "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
            "A String",
          ],
          "placements": [ # Requests containing any of these placements will match.
            {
              "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
              "type": "A String", # The type of the placement.
            },
          ],
        }

`list(accountId)`

    Retrieves a list of the authenticated user's pretargeting configurations.

    Args:
      accountId: string, The account id to get the pretargeting configs for. (required)

    Returns:
      An object of the form:

        {
        "items": [ # A list of pretargeting configs
          {
              "verticals": [ # Requests containing any of these vertical ids will match.
                "A String",
              ],
              "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.
                "A String",
              ],
              "videoPlayerSizes": [ # Video requests satisfying any of these player size constraints will match.
                {
                  "minWidth": "A String", # The minimum player width in pixels. Leave this field blank to match any player width.
                  "aspectRatio": "A String", # The type of aspect ratio. Leave this field blank to match all aspect ratios.
                  "minHeight": "A String", # The minimum player height in pixels. Leave this field blank to match any player height.
                },
              ],
              "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests.
              "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.
                "A String",
              ],
              "configName": "A String", # The name of the config. Must be unique. Required for all requests.
              "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match.
                "A String",
              ],
              "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.
                "A String",
              ],
              "languages": [ # Request containing any of these language codes will match.
                "A String",
              ],
              "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.
                "A String",
              ],
              "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.
                "A String",
              ],
              "excludedPlacements": [ # Requests containing any of these placements will not match.
                {
                  "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
                  "type": "A String", # The type of the placement.
                },
              ],
              "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
              "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
                "A String",
              ],
              "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.
                "A String",
              ],
              "excludedUserLists": [ # Requests containing any of these users list ids will not match.
                "A String",
              ],
              "isActive": True or False, # Whether this config is active. Required for all requests.
              "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
                {
                  "width": "A String", # Width in pixels.
                  "height": "A String", # Height in pixels.
                },
              ],
              "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
              "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
                "A String",
              ],
              "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
                "A String",
              ],
              "userLists": [ # Requests containing any of these user list ids will match.
                "A String",
              ],
              "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
                "A String",
              ],
              "placements": [ # Requests containing any of these placements will match.
                {
                  "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
                  "type": "A String", # The type of the placement.
                },
              ],
            },
        ],
        "kind": "adexchangebuyer#pretargetingConfigList", # Resource type.
      }

`patch(accountId, configId, body)`

    Updates an existing pretargeting config. This method supports patch semantics.

    Args:
      accountId: string, The account id to update the pretargeting config for. (required)
      configId: string, The specific id of the configuration to update. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "verticals": [ # Requests containing any of these vertical ids will match.
          "A String",
        ],
        "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.
          "A String",
        ],
        "videoPlayerSizes": [ # Video requests satisfying any of these player size constraints will match.
          {
            "minWidth": "A String", # The minimum player width in pixels. Leave this field blank to match any player width.
            "aspectRatio": "A String", # The type of aspect ratio. Leave this field blank to match all aspect ratios.
            "minHeight": "A String", # The minimum player height in pixels. Leave this field blank to match any player height.
          },
        ],
        "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests.
        "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.
          "A String",
        ],
        "configName": "A String", # The name of the config. Must be unique. Required for all requests.
        "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match.
          "A String",
        ],
        "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.
          "A String",
        ],
        "languages": [ # Request containing any of these language codes will match.
          "A String",
        ],
        "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.
          "A String",
        ],
        "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.
          "A String",
        ],
        "excludedPlacements": [ # Requests containing any of these placements will not match.
          {
            "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
            "type": "A String", # The type of the placement.
          },
        ],
        "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
        "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
          "A String",
        ],
        "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.
          "A String",
        ],
        "excludedUserLists": [ # Requests containing any of these users list ids will not match.
          "A String",
        ],
        "isActive": True or False, # Whether this config is active. Required for all requests.
        "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
          {
            "width": "A String", # Width in pixels.
            "height": "A String", # Height in pixels.
          },
        ],
        "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
        "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
          "A String",
        ],
        "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
          "A String",
        ],
        "userLists": [ # Requests containing any of these user list ids will match.
          "A String",
        ],
        "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
          "A String",
        ],
        "placements": [ # Requests containing any of these placements will match.
          {
            "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
            "type": "A String", # The type of the placement.
          },
        ],
      }

    Returns:
      An object of the form:

        {
          "verticals": [ # Requests containing any of these vertical ids will match.
            "A String",
          ],
          "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.
            "A String",
          ],
          "videoPlayerSizes": [ # Video requests satisfying any of these player size constraints will match.
            {
              "minWidth": "A String", # The minimum player width in pixels. Leave this field blank to match any player width.
              "aspectRatio": "A String", # The type of aspect ratio. Leave this field blank to match all aspect ratios.
              "minHeight": "A String", # The minimum player height in pixels. Leave this field blank to match any player height.
            },
          ],
          "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests.
          "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.
            "A String",
          ],
          "configName": "A String", # The name of the config. Must be unique. Required for all requests.
          "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match.
            "A String",
          ],
          "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.
            "A String",
          ],
          "languages": [ # Request containing any of these language codes will match.
            "A String",
          ],
          "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.
            "A String",
          ],
          "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.
            "A String",
          ],
          "excludedPlacements": [ # Requests containing any of these placements will not match.
            {
              "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
              "type": "A String", # The type of the placement.
            },
          ],
          "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
          "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
            "A String",
          ],
          "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.
            "A String",
          ],
          "excludedUserLists": [ # Requests containing any of these users list ids will not match.
            "A String",
          ],
          "isActive": True or False, # Whether this config is active. Required for all requests.
          "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
            {
              "width": "A String", # Width in pixels.
              "height": "A String", # Height in pixels.
            },
          ],
          "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
          "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
            "A String",
          ],
          "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
            "A String",
          ],
          "userLists": [ # Requests containing any of these user list ids will match.
            "A String",
          ],
          "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
            "A String",
          ],
          "placements": [ # Requests containing any of these placements will match.
            {
              "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
              "type": "A String", # The type of the placement.
            },
          ],
        }

`update(accountId, configId, body)`

    Updates an existing pretargeting config.

    Args:
      accountId: string, The account id to update the pretargeting config for. (required)
      configId: string, The specific id of the configuration to update. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "verticals": [ # Requests containing any of these vertical ids will match.
          "A String",
        ],
        "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.
          "A String",
        ],
        "videoPlayerSizes": [ # Video requests satisfying any of these player size constraints will match.
          {
            "minWidth": "A String", # The minimum player width in pixels. Leave this field blank to match any player width.
            "aspectRatio": "A String", # The type of aspect ratio. Leave this field blank to match all aspect ratios.
            "minHeight": "A String", # The minimum player height in pixels. Leave this field blank to match any player height.
          },
        ],
        "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests.
        "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.
          "A String",
        ],
        "configName": "A String", # The name of the config. Must be unique. Required for all requests.
        "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match.
          "A String",
        ],
        "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.
          "A String",
        ],
        "languages": [ # Request containing any of these language codes will match.
          "A String",
        ],
        "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.
          "A String",
        ],
        "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.
          "A String",
        ],
        "excludedPlacements": [ # Requests containing any of these placements will not match.
          {
            "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
            "type": "A String", # The type of the placement.
          },
        ],
        "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
        "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
          "A String",
        ],
        "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.
          "A String",
        ],
        "excludedUserLists": [ # Requests containing any of these users list ids will not match.
          "A String",
        ],
        "isActive": True or False, # Whether this config is active. Required for all requests.
        "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
          {
            "width": "A String", # Width in pixels.
            "height": "A String", # Height in pixels.
          },
        ],
        "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
        "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
          "A String",
        ],
        "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
          "A String",
        ],
        "userLists": [ # Requests containing any of these user list ids will match.
          "A String",
        ],
        "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
          "A String",
        ],
        "placements": [ # Requests containing any of these placements will match.
          {
            "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
            "type": "A String", # The type of the placement.
          },
        ],
      }

    Returns:
      An object of the form:

        {
          "verticals": [ # Requests containing any of these vertical ids will match.
            "A String",
          ],
          "platforms": [ # Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.
            "A String",
          ],
          "videoPlayerSizes": [ # Video requests satisfying any of these player size constraints will match.
            {
              "minWidth": "A String", # The minimum player width in pixels. Leave this field blank to match any player width.
              "aspectRatio": "A String", # The type of aspect ratio. Leave this field blank to match all aspect ratios.
              "minHeight": "A String", # The minimum player height in pixels. Leave this field blank to match any player height.
            },
          ],
          "configId": "A String", # The config id; generated automatically. Leave this field blank for insert requests.
          "excludedVerticals": [ # Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.
            "A String",
          ],
          "configName": "A String", # The name of the config. Must be unique. Required for all requests.
          "excludedGeoCriteriaIds": [ # Requests containing any of these geo criteria ids will not match.
            "A String",
          ],
          "excludedContentLabels": [ # Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.
            "A String",
          ],
          "languages": [ # Request containing any of these language codes will match.
            "A String",
          ],
          "mobileDevices": [ # Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.
            "A String",
          ],
          "mobileCarriers": [ # Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.
            "A String",
          ],
          "excludedPlacements": [ # Requests containing any of these placements will not match.
            {
              "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
              "type": "A String", # The type of the placement.
            },
          ],
          "billingId": "A String", # The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.
          "geoCriteriaIds": [ # Requests containing any of these geo criteria ids will match.
            "A String",
          ],
          "mobileOperatingSystemVersions": [ # Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.
            "A String",
          ],
          "excludedUserLists": [ # Requests containing any of these users list ids will not match.
            "A String",
          ],
          "isActive": True or False, # Whether this config is active. Required for all requests.
          "dimensions": [ # Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.
            {
              "width": "A String", # Width in pixels.
              "height": "A String", # Height in pixels.
            },
          ],
          "kind": "adexchangebuyer#pretargetingConfig", # The kind of the resource, i.e. "adexchangebuyer#pretargetingConfig".
          "supportedCreativeAttributes": [ # Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.
            "A String",
          ],
          "vendorTypes": [ # Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.
            "A String",
          ],
          "userLists": [ # Requests containing any of these user list ids will match.
            "A String",
          ],
          "creativeType": [ # List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.
            "A String",
          ],
          "placements": [ # Requests containing any of these placements will match.
            {
              "token": "A String", # The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement.
              "type": "A String", # The type of the placement.
            },
          ],
        }