Method: monetization.onetimeproducts.purchaseOptions.offers.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet alle Angebote für eine bestimmte App, ein bestimmtes Produkt oder eine bestimmte Kaufoption auf.
HTTP-Anfrage
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
packageName |
string
Erforderlich. Die übergeordnete App (Paketname), für die die Angebote gelesen werden sollen.
|
productId |
string
Erforderlich. Das übergeordnete Einmalprodukt (ID), für das die Angebote gelesen werden sollen. Kann als „-“ angegeben werden, um alle Angebote für eine App zu lesen.
|
purchaseOptionId |
string
Erforderlich. Die übergeordnete Kaufoption (ID), für die die Angebote gelesen werden sollen. Kann als „-“ angegeben werden, um alle Angebote für ein Einmalkaufprodukt oder eine App zu lesen. Muss als „-“ angegeben werden, wenn „productId“ als „-“ angegeben wird.
|
Abfrageparameter
Parameter |
pageSize |
integer
Optional. Die maximale Anzahl der Angebote, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Angebote zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.
|
pageToken |
string
Optional. Ein Seitentoken, das von einem vorherigen ListOneTimeProductsOffers -Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen die für ListOneTimeProductsOffersRequest bereitgestellten Parameter „productId“, „packageName“ und „purchaseOptionId“ mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht für offers.list.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"oneTimeProductOffers": [
{
object (OneTimeProductOffer )
}
],
"nextPageToken": string
} |
Felder |
oneTimeProductOffers[] |
object (OneTimeProductOffer )
Die einmaligen Produktangebote aus der angegebenen Anfrage.
|
nextPageToken |
string
Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidpublisher
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[],[],null,["# Method: monetization.onetimeproducts.purchaseOptions.offers.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.ListOneTimeProductOffersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all offers under a given app, product, or purchase option.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) for which the offers should be read. |\n| `productId` | `string` Required. The parent one-time product (ID) for which the offers should be read. May be specified as '-' to read all offers under an app. |\n| `purchaseOptionId` | `string` Required. The parent purchase option (ID) for which the offers should be read. May be specified as '-' to read all offers under a one-time product or an app. Must be specified as '-' if productId is specified as '-'. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Optional. The maximum number of offers to return. The service may return fewer than this value. If unspecified, at most 50 offers will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. |\n| `pageToken` | `string` Optional. A page token, received from a previous `ListOneTimeProductsOffers` call. Provide this to retrieve the subsequent page. When paginating, productId, packageName and purchaseOptionId provided to `ListOneTimeProductsOffersRequest` 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 offers.list.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"oneTimeProductOffers\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `oneTimeProductOffers[]` | `object (`[OneTimeProductOffer](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer)`)` The oneTimeProduct offers from the specified request. |\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/androidpublisher`"]]