Method: inventorySourceGroups.get

  • This page provides documentation for the Display & Video 360 API v3 method for getting an inventory source group, though v3 has been sunset and v4 should be used instead.

  • To get an inventory source group, a GET request is made to the specified URL using gRPC Transcoding syntax, including the required inventorySourceGroupId path parameter.

  • The request requires a required union parameter accessor in the query parameters to identify the DV360 entity (partner or advertiser) making the request and verify access to the inventory source group.

  • The request body must be empty, and a successful response will contain an instance of InventorySourceGroup.

  • The request requires authorization using the https://www.googleapis.com/auth/display-video OAuth scope.

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.