Method: accounts.promotions.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-01-23 UTC.
[null,null,["Son güncelleme tarihi: 2025-01-23 UTC."],[[["\u003cp\u003eLists all processed promotions for a given Merchant Center account, allowing pagination for large result sets.\u003c/p\u003e\n"],["\u003cp\u003eProvides detailed information about each promotion, including potential product restrictions and offer details.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope for access.\u003c/p\u003e\n"],["\u003cp\u003eResponses may be delayed for recently created or updated promotions due to processing time.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes HTTP GET requests with path and query parameters for specifying the target account and pagination control.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of promotions from a Merchant Center account using an HTTP GET request. The URL requires the account ID as a `parent` path parameter. Optional query parameters include `pageSize` (maximum promotions to return, up to 250) and `pageToken` (for pagination). The request body must be empty. The response includes an array of `promotions` and an optional `nextPageToken` for subsequent pages. Authentication requires the `https://www.googleapis.com/auth/content` OAuth scope. Updated promotions might take time to be retrievable.\n"],null,["# Method: accounts.promotions.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.ListPromotionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the promotions in your Merchant Center account. The response might contain fewer items than specified by `pageSize`. Rely on `pageToken` to determine if there are more items to be requested.\n\nAfter inserting or updating a promotion, it may take several minutes before the updated processed promotion can be retrieved.\n\n### HTTP request\n\n`GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The account to list processed promotions for. Format: `accounts/{account}` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Optional. The maximum number of promotions to return. The service may return fewer than this value. The maximum value is 250; values above 250 will be coerced to 250. If unspecified, the maximum number of promotions will be returned. |\n| `pageToken` | `string` Optional. A page token, received from a previous `promotions.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `promotions.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the `promotions.list` method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"promotions\": [ { object (/merchant/api/reference/rest/promotions_v1beta/accounts.promotions#Promotion) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `promotions[]` | `object (`[Promotion](/merchant/api/reference/rest/promotions_v1beta/accounts.promotions#Promotion)`)` The processed promotions from the specified account. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
