Method: buyers.publisherProfiles.list
Stay organized with collections
Save and categorize content based on your preferences.
Lists publisher profiles. The returned publisher profiles aren't in any defined order. The order of the results might change. A new publisher profile can appear in any place in the list of returned results.
HTTP request
GET https://authorizedbuyersmarketplace.googleapis.com/v1/{parent=buyers/*}/publisherProfiles
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
parent |
string
Required. Parent that owns the collection of publisher profiles Format: buyers/{buyerId}
|
Query parameters
Parameters |
pageSize |
integer
Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results per page. If unspecified, the server will pick a default page size of 100.
|
pageToken |
string
The page token as returned from a previous ListPublisherProfilesResponse.
|
filter |
string
Optional query string using the Cloud API list filtering syntax.
|
Request body
The request body must be empty.
Response body
Response message for profiles visible to the buyer.
If successful, the response body contains data with the following structure:
JSON representation |
{
"publisherProfiles": [
{
object (PublisherProfile )
}
],
"nextPageToken": string
} |
Fields |
publisherProfiles[] |
object (PublisherProfile )
The list of matching publisher profiles.
|
nextPageToken |
string
Token to fetch the next page of results.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/authorized-buyers-marketplace
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-12 UTC.
[null,null,["Last updated 2025-06-12 UTC."],[[["\u003cp\u003eLists publisher profiles visible to a buyer, with results potentially changing order and new profiles appearing in any position.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering and pagination using query parameters like \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003efilter\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of publisher profiles and a token for fetching subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/authorized-buyers-marketplace\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the endpoint \u003ccode\u003ehttps://authorizedbuyersmarketplace.googleapis.com/v1/{parent=buyers/*}/publisherProfiles\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: buyers.publisherProfiles.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPublisherProfilesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists publisher profiles. The returned publisher profiles aren't in any defined order. The order of the results might change. A new publisher profile can appear in any place in the list of returned results.\n\n### HTTP request\n\n`GET https://authorizedbuyersmarketplace.googleapis.com/v1/{parent=buyers/*}/publisherProfiles`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Parent that owns the collection of publisher profiles Format: `buyers/{buyerId}` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results per page. If unspecified, the server will pick a default page size of 100. |\n| `pageToken` | `string` The page token as returned from a previous ListPublisherProfilesResponse. |\n| `filter` | `string` Optional query string using the [Cloud API list filtering](https://developers.google.com/authorized-buyers/apis/guides/list-filters) syntax. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for profiles visible to the buyer.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"publisherProfiles\": [ { object (/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.publisherProfiles#PublisherProfile) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `publisherProfiles[]` | `object (`[PublisherProfile](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.publisherProfiles#PublisherProfile)`)` The list of matching publisher profiles. |\n| `nextPageToken` | `string` Token to fetch the next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/authorized-buyers-marketplace`"]]