Method: buyers.dataSegments.list

  • This endpoint retrieves a list of data segments accessible by a specified buyer, using the format buyers/{accountId} in the parent path parameter.

  • The GET HTTP request is made to https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{parent=buyers/*}/dataSegments to obtain data segment information.

  • Optional query parameters pageSize and pageToken can be used to manage pagination of the response, and pageSize has a maximum value of 500.

  • The response body includes a list of data segments, represented as an array of DataSegment objects, and a nextPageToken string for retrieving additional pages.

  • The request must have an empty body and use the OAuth scope https://www.googleapis.com/auth/authorized-buyers-marketplace to get authorized.

List the data segments owned by a curator.

HTTP request

GET https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{parent=buyers/*}/dataSegments

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Name of the parent curator that can access the data segment. v1alpha format: buyers/{accountId} v1beta format: curators/{accountId}

Query parameters

Parameters
pageSize

integer

Optional. Requested page size. The server may return fewer results than requested. Max allowed page size is 500. If unspecified, the server will default to 500.

pageToken

string

Optional. The page token as returned. ListDataSegmentsResponse.nextPageToken

Request body

The request body must be empty.

Response body

Response message for listing data segments.

If successful, the response body contains data with the following structure:

JSON representation
{
  "dataSegments": [
    {
      object (DataSegment)
    }
  ],
  "nextPageToken": string
}
Fields
dataSegments[]

object (DataSegment)

The list of data segments.

nextPageToken

string

Continuation token for fetching the next page of results. Pass this value in the ListDataSegmentsRequest.pageToken field in the subsequent call to the dataSegments.list method to retrieve the next page of results.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/authorized-buyers-marketplace