Google Display & Video 360 API

openapi: 3.1.0
info:
  title: Google Display & Video 360 API
  description: Display & Video 360 API allows users to automate complex Display & Video 360 workflows,
    such as creating insertion orders and setting targeting options for individual line items. Derived
    mechanically from the first-party Google API Discovery Document at https://displayvideo.googleapis.com/$discovery/rest?version=v4
    (revision 20260813).
  version: v4
  contact:
    name: Google
    url: https://developers.google.com/display-video/
  license:
    name: Google APIs Terms of Service
    url: https://developers.google.com/terms
  termsOfService: https://developers.google.com/terms
  x-google-discovery-revision: '20260813'
  x-google-discovery-document: https://displayvideo.googleapis.com/$discovery/rest?version=v4
servers:
- url: https://displayvideo.googleapis.com
  description: Display & Video 360 API server
security:
- oauth2:
  - https://www.googleapis.com/auth/display-video
tags:
- name: Users
- name: Guaranteed Orders
- name: Media
- name: Custom Lists
- name: First Party and Partner Audiences
- name: Floodlight Groups
- name: Targeting Types
- name: SDF Download Tasks
- name: Inventory Source Groups
- name: Advertisers
- name: Google Audiences
- name: Partners
- name: Inventory Sources
- name: SDF Upload Tasks
- name: Combined Audiences
- name: Custom Bidding Algorithms
paths:
  /v4/users:
    get:
      operationId: usersList
      summary: Lists users that are accessible to the current user.
      description: Lists users that are accessible to the current user. If two users have user roles on
        the same partner or advertiser, they can access each other. This method has unique authentication
        requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites)
        before using this method. The "Try this method" feature does not work for this method.
      tags:
      - Users
      parameters:
      - name: pageSize
        in: query
        schema:
          type: integer
          format: int32
        description: Requested page size. Must be between `1` and `200`. If unspecified will default to
          `100`.
      - name: orderBy
        in: query
        schema:
          type: string
        description: 'Field by which to sort the list. Acceptable values are: * `displayName` (default)
          The default sorting order is ascending. To specify descending order for a field, a suffix "desc"
          should be added to the field name. For example, `displayName desc`.'
      - name: pageToken
        in: query
        schema:
          type: string
        description: A token identifying a page of results the server should return. Typically, this is
          the value of next_page_token returned from the previous call to `ListUsers` method. If not specified,
          the first page of results will be returned.
      - name: filter
        in: query
        schema:
          type: string
        description: 'Allows filtering by user fields. Supported syntax: * Filter expressions are made
          up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`.
          * A restriction has the form of `{field} {operator} {value}`. * The `displayName` and `email`
          fields must use the `HAS (:)` operator. * The `lastLoginTime` field must use either the `LESS
          THAN OR EQUAL TO (<=)` or `GREATER THAN OR EQUAL TO (>=)` operator. * All other fields must
          use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType`:
          This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity
          to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId`:
          This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner
          of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole`
          * `displayName` * `email` * `lastLoginTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`)
          Examples: * The user with `displayName` containing "foo": `displayName:"foo"` * The user with
          `email` containing "bar": `email:"bar"` * All users with standard user roles: `assignedUserRole.userRole="STANDARD"`
          * All users with user roles for partner 123: `assignedUserRole.partnerId="123"` * All users
          with user roles for advertiser 123: `assignedUserRole.advertiserId="123"` * All users with partner
          level user roles: `entityType="PARTNER"` * All users with user roles for partner 123 and advertisers
          under partner 123: `parentPartnerId="123"` * All users that last logged in on or after 2023-01-01T00:00:00Z
          (format of ISO 8601): `lastLoginTime>="2023-01-01T00:00:00Z"` The length of this field should
          be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters)
          guide for more information.'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUsersResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video-user-management
      x-google-method-id: displayvideo.users.list
    post:
      operationId: usersCreate
      summary: Creates a new user.
      description: Creates a new user. Returns the newly created user if successful. This method has unique
        authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites)
        before using this method. The "Try this method" feature does not work for this method.
      tags:
      - Users
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/User'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video-user-management
      x-google-method-id: displayvideo.users.create
  /v4/users/{usersId}:bulkEditAssignedUserRoles:
    post:
      operationId: usersBulkEditAssignedUserRoles
      summary: Bulk edits user roles for a user.
      description: Bulk edits user roles for a user. The operation will delete the assigned user roles
        provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user
        roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles. This method has unique
        authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites)
        before using this method. The "Try this method" feature does not work for this method.
      tags:
      - Users
      parameters:
      - name: userId
        in: path
        schema:
          type: string
          format: int64
          pattern: ^[^/]+$
        description: Required. The ID of the user to which the assigned user roles belong.
        required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkEditAssignedUserRolesRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkEditAssignedUserRolesResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video-user-management
      x-google-method-id: displayvideo.users.bulkEditAssignedUserRoles
  /v4/users/{usersId}:
    patch:
      operationId: usersPatch
      summary: Updates an existing user.
      description: Updates an existing user. Returns the updated user if successful. This method has unique
        authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites)
        before using this method. The "Try this method" feature does not work for this method.
      tags:
      - Users
      parameters:
      - name: userId
        in: path
        schema:
          type: string
          format: int64
          pattern: ^[^/]+$
        description: Output only. The unique ID of the user. Assigned by the system.
        required: true
      - name: updateMask
        in: query
        schema:
          type: string
          format: google-fieldmask
        description: Required. The mask to control which fields to update.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/User'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video-user-management
      x-google-method-id: displayvideo.users.patch
    get:
      operationId: usersGet
      summary: Gets a user.
      description: Gets a user. This method has unique authentication requirements. Read the prerequisites
        in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using
        this method. The "Try this method" feature does not work for this method.
      tags:
      - Users
      parameters:
      - name: userId
        in: path
        schema:
          type: string
          format: int64
          pattern: ^[^/]+$
        description: Required. The ID of the user to fetch.
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video-user-management
      x-google-method-id: displayvideo.users.get
    delete:
      operationId: usersDelete
      summary: Deletes a user.
      description: Deletes a user. This method has unique authentication requirements. Read the prerequisites
        in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using
        this method. The "Try this method" feature does not work for this method.
      tags:
      - Users
      parameters:
      - name: userId
        in: path
        schema:
          type: string
          format: int64
          pattern: ^[^/]+$
        description: Required. The ID of the user to delete.
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Empty'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video-user-management
      x-google-method-id: displayvideo.users.delete
  /v4/guaranteedOrders:
    post:
      operationId: guaranteedOrdersCreate
      summary: Creates a new guaranteed order.
      description: Creates a new guaranteed order. Returns the newly created guaranteed order if successful.
      tags:
      - Guaranteed Orders
      parameters:
      - name: advertiserId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the advertiser that the request is being made within.
      - name: partnerId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the partner that the request is being made within.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GuaranteedOrder'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GuaranteedOrder'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.guaranteedOrders.create
    get:
      operationId: guaranteedOrdersList
      summary: Lists guaranteed orders that are accessible to the current user.
      description: Lists guaranteed orders that are accessible to the current user. The order is defined
        by the order_by parameter. If a filter by entity_status is not specified, guaranteed orders with
        entity status `ENTITY_STATUS_ARCHIVED` will not be included in the results.
      tags:
      - Guaranteed Orders
      parameters:
      - name: pageSize
        in: query
        schema:
          type: integer
          format: int32
        description: Requested page size. Must be between `1` and `200`. If unspecified will default to
          `100`.
      - name: pageToken
        in: query
        schema:
          type: string
        description: A token identifying a page of results the server should return. Typically, this is
          the value of next_page_token returned from the previous call to `ListGuaranteedOrders` method.
          If not specified, the first page of results will be returned.
      - name: filter
        in: query
        schema:
          type: string
        description: 'Allows filtering by guaranteed order fields. * Filter expressions are made up of
          one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators.
          A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator}
          {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `guaranteed_order_id`
          * `exchange` * `display_name` * `status.entityStatus` Examples: * All active guaranteed orders:
          `status.entityStatus="ENTITY_STATUS_ACTIVE"` * Guaranteed orders belonging to Google Ad Manager
          or Rubicon exchanges: `exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"`
          The length of this field should be no more than 500 characters. Reference our [filter `LIST`
          requests](/display-video/api/guides/how-tos/filters) guide for more information.'
      - name: partnerId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the partner that has access to the guaranteed order.
      - name: advertiserId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the advertiser that has access to the guaranteed order.
      - name: orderBy
        in: query
        schema:
          type: string
        description: 'Field by which to sort the list. Acceptable values are: * `displayName` (default)
          The default sorting order is ascending. To specify descending order for a field, a suffix "desc"
          should be added to the field name. For example, `displayName desc`.'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListGuaranteedOrdersResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.guaranteedOrders.list
  /v4/guaranteedOrders/{guaranteedOrdersId}:editGuaranteedOrderReadAccessors:
    post:
      operationId: guaranteedOrdersEditGuaranteedOrderReadAccessors
      summary: Edits read advertisers of a guaranteed order.
      description: Edits read advertisers of a guaranteed order.
      tags:
      - Guaranteed Orders
      parameters:
      - name: guaranteedOrderId
        in: path
        schema:
          type: string
          pattern: ^[^/]+$
        description: Required. The ID of the guaranteed order to edit. The ID is of the format `{exchange}-{legacy_guaranteed_order_id}`
        required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditGuaranteedOrderReadAccessorsRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EditGuaranteedOrderReadAccessorsResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.guaranteedOrders.editGuaranteedOrderReadAccessors
  /v4/guaranteedOrders/{guaranteedOrdersId}:
    get:
      operationId: guaranteedOrdersGet
      summary: Gets a guaranteed order.
      description: Gets a guaranteed order.
      tags:
      - Guaranteed Orders
      parameters:
      - name: guaranteedOrderId
        in: path
        schema:
          type: string
          pattern: ^[^/]+$
        description: Required. The ID of the guaranteed order to fetch. The ID is of the format `{exchange}-{legacy_guaranteed_order_id}`
        required: true
      - name: partnerId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the partner that has access to the guaranteed order.
      - name: advertiserId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the advertiser that has access to the guaranteed order.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GuaranteedOrder'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.guaranteedOrders.get
    patch:
      operationId: guaranteedOrdersPatch
      summary: Updates an existing guaranteed order.
      description: Updates an existing guaranteed order. Returns the updated guaranteed order if successful.
      tags:
      - Guaranteed Orders
      parameters:
      - name: guaranteedOrderId
        in: path
        schema:
          type: string
          pattern: ^[^/]+$
        description: Output only. The unique identifier of the guaranteed order. The guaranteed order
          IDs have the format `{exchange}-{legacy_guaranteed_order_id}`.
        required: true
      - name: updateMask
        in: query
        schema:
          type: string
          format: google-fieldmask
        description: Required. The mask to control which fields to update.
      - name: advertiserId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the advertiser that the request is being made within.
      - name: partnerId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the partner that the request is being made within.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GuaranteedOrder'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GuaranteedOrder'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.guaranteedOrders.patch
  /media/{mediaId}:
    post:
      operationId: mediaUpload
      summary: Uploads media.
      description: 'Uploads media. Upload is supported on the URI `/upload/media/{resource_name=**}?upload_type=media.`
        **Note**: Upload requests will not be successful without including `upload_type=media` query string.'
      tags:
      - Media
      parameters:
      - name: resourceName
        in: path
        schema:
          type: string
          pattern: ^.*$
        description: Name of the media that is being downloaded. See ReadRequest.resource_name.
        required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleBytestreamMedia'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleBytestreamMedia'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
        - https://www.googleapis.com/auth/doubleclickbidmanager
      x-google-supports-media-upload: true
      x-google-method-id: displayvideo.media.upload
  /download/{downloadId}:
    get:
      operationId: mediaDownload
      summary: Downloads media.
      description: 'Downloads media. Download is supported on the URI `/download/{resource_name=**}?alt=media.`
        **Note**: Download requests will not be successful without including `alt=media` query string.'
      tags:
      - Media
      parameters:
      - name: resourceName
        in: path
        schema:
          type: string
          pattern: ^.*$
        description: Name of the media that is being downloaded. See ReadRequest.resource_name.
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleBytestreamMedia'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
        - https://www.googleapis.com/auth/doubleclickbidmanager
      x-google-supports-media-download: true
      x-google-method-id: displayvideo.media.download
  /v4/customLists/{customListsId}:
    get:
      operationId: customListsGet
      summary: Gets a custom list.
      description: Gets a custom list.
      tags:
      - Custom Lists
      parameters:
      - name: customListId
        in: path
        schema:
          type: string
          format: int64
          pattern: ^[^/]+$
        description: Required. The ID of the custom list to fetch.
        required: true
      - name: advertiserId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the DV360 advertiser that has access to the fetched custom lists.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomList'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.customLists.get
  /v4/customLists:
    get:
      operationId: customListsList
      summary: Lists custom lists.
      description: Lists custom lists. The order is defined by the order_by parameter.
      tags:
      - Custom Lists
      parameters:
      - name: filter
        in: query
        schema:
          type: string
        description: 'Allows filtering by custom list fields. Supported syntax: * Filter expressions for
          custom lists can only contain at most one restriction. * A restriction has the form of `{field}
          {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName`
          Examples: * All custom lists for which the display name contains "Google": `displayName:"Google"`.
          The length of this field should be no more than 500 characters. Reference our [filter `LIST`
          requests](/display-video/api/guides/how-tos/filters) guide for more information.'
      - name: pageToken
        in: query
        schema:
          type: string
        description: A token identifying a page of results the server should return. Typically, this is
          the value of next_page_token returned from the previous call to `ListCustomLists` method. If
          not specified, the first page of results will be returned.
      - name: pageSize
        in: query
        schema:
          type: integer
          format: int32
        description: Requested page size. Must be between `1` and `200`. If unspecified will default to
          `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.
      - name: advertiserId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the DV360 advertiser that has access to the fetched custom lists.
      - name: orderBy
        in: query
        schema:
          type: string
        description: 'Field by which to sort the list. Acceptable values are: * `customListId` (default)
          * `displayName` The default sorting order is ascending. To specify descending order for a field,
          a suffix "desc" should be added to the field name. Example: `displayName desc`.'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCustomListsResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.customLists.list
  /v4/firstPartyAndPartnerAudiences/{firstPartyAndPartnerAudiencesId}:editCustomerMatchMembers:
    post:
      operationId: firstPartyAndPartnerAudiencesEditCustomerMatchMembers
      summary: Updates the member list of a Customer Match audience.
      description: 'Updates the member list of a Customer Match audience. Only supported for the following
        audience_type: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`'
      tags:
      - First Party and Partner Audiences
      parameters:
      - name: firstPartyAndPartnerAudienceId
        in: path
        schema:
          type: string
          format: int64
          pattern: ^[^/]+$
        description: Required. The ID of the Customer Match FirstPartyAndPartnerAudience whose members
          will be edited.
        required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditCustomerMatchMembersRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EditCustomerMatchMembersResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.firstPartyAndPartnerAudiences.editCustomerMatchMembers
  /v4/firstPartyAndPartnerAudiences:
    get:
      operationId: firstPartyAndPartnerAudiencesList
      summary: Lists first party and partner audiences.
      description: Lists first party and partner audiences. The order is defined by the order_by parameter.
      tags:
      - First Party and Partner Audiences
      parameters:
      - name: partnerId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the partner that has access to the fetched first party and partner audiences.
      - name: advertiserId
        in: query
        schema:
          type: string
          format: int64
        description: The ID of the advertiser that has access to the fetched first party and partner audiences.
      - name: orderBy
        in: query
        schema:
          type: string
        description: 'Optional. Field by which to sort the list. Acceptable values are: * `FirstPartyAndPartnerAudienceId`
          (default) * `displayName` The default sorting order is ascending. To specify descending order
          for a field, a suffix "desc" should be added to the field name. Example: `displayName desc`.'
      - name: pageSize
        in: query
        schema:
          type: integer
          format: int32
        description: Optional. Requested page size. Must be between `1` and `5000`. If unspecified, this
          value defaults to `5000`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.
      - name: pageToken
        in: query
        schema:
          type: string
        description: Optional. A token identifying a page of results the server should return. Typically,
          this is the value of next_page_token returned from the previous call to `ListFirstPartyAndPartnerAudiences`
          method. If not specified, the first page of results will be returned.
      - name: filter
        in: query
        schema:
          type: string
        description: 'Optional. Allows filtering by first party and partner audience fields. Supported
          syntax: * Filter expressions for first party and partner audiences can only contain at most
          one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields
          must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All first party
          and partner audiences for which the display name contains "Google": `displayName:"Google"`.
          The length of this field should be no more than 500 characters. Reference our [filter `LIST`
          requests](/display-video/api/guides/how-tos/filters) guide for more information.'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFirstPartyAndPartnerAudiencesResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.firstPartyAndPartnerAudiences.list
    post:
      operationId: firstPartyAndPartnerAudiencesCreate
      summary: Creates a FirstPartyAndPartnerAudience.
      description: 'Creates a FirstPartyAndPartnerAudience. Only supported for the following audience_type:
        * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`'
      tags:
      - First Party and Partner Audiences
      parameters:
      - name: advertiserId
        in: query
        schema:
          type: string
          format: int64
        description: Required. The ID of the advertiser under whom the FirstPartyAndPartnerAudience will
          be created.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FirstPartyAndPartnerAudience'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FirstPartyAndPartnerAudience'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/display-video
      x-google-method-id: displayvideo.firstPartyAndPartnerAudiences.create
  /v4/firstPartyAndPartnerAudiences/{firstPartyAndPartnerAudiencesId}:
    patch:
      operationId: firstPartyAndPartnerAudiencesPatch
      summary: Updates an existing FirstPartyAndPartnerAudience.
      description: 'Updates an existing FirstPartyAndPartnerAudience. Only supported for the following
        audience_type: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`'
      tags:
      - First Party and Partner Audiences
      parameters:
      - name: firstPartyAndPartnerAudienceId
        in: path
        schema:
          type: string
          format: int64
          pattern: ^[^/]+$
        description: Identifier. The unique ID of the first party and partner audience. Assigned by the
          system.
        required: true
      - name: updateMask
        in: query
        schema:
          type: string
          format: google-fieldmask
        description: 'Required. The mask to control which fields to update. Updates are only supported
          for the following fields: * `displayName` * `description` * `membershipDurationDays`'
      - name: advertiserId
        in: query
        schema:
          type: string
          format: int64
        description: Required. The ID of the owner advertiser of the updated FirstPartyAndPartnerAudience.
      requestBody:
        required: true
        content:
          a

# --- truncated at 32 KB (1176 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/google-display-video-360/refs/heads/main/openapi/google-display-video-360-api-openapi.yml