Method: inventorySourceGroups.get

  • This operation retrieves a specific inventory source group using its ID.

  • It requires specifying an accessor in the query parameters, which can be either a partnerId or an advertiserId, to define the entity requesting access.

  • Only inventory source groups accessible to the specified accessor will be returned.

  • Authorization with the https://www.googleapis.com/auth/display-video scope is necessary.

  • The response provides the details of the inventory source group if the request is successful.

Gets an inventory source group.

HTTP request

GET https://displayvideo.googleapis.com/v3/inventorySourceGroups/{inventorySourceGroupId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
inventorySourceGroupId

string (int64 format)

Required. The ID of the inventory source group to fetch.

Query parameters

Parameters
Union parameter accessor. Required. Identifies which DV360 entity the request is being made within. The GET request will only return the inventory source group entity if it is accessible to the DV360 entity identified within the accessor. accessor can be only one of the following:
partnerId

string (int64 format)

The ID of the partner that has access to the inventory source group.

A partner cannot access an advertiser-owned inventory source group.
advertiserId

string (int64 format)

The ID of the advertiser that has access to the inventory source group.

If an inventory source group is partner-owned, only advertisers to which the group is explicitly shared can access the group.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of InventorySourceGroup.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/display-video

For more information, see the OAuth 2.0 Overview.