Method: monetization.onetimeproducts.purchaseOptions.batchDelete
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Supprime les options d'achat pour un ou plusieurs produits ponctuels.
Par défaut, cette opération échoue si des offres existent pour les options d'achat supprimées. Utilisez le paramètre "force" pour remplacer le comportement par défaut.
Requête HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchDelete
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
packageName |
string
Obligatoire. Application parente (nom du package) des options d'achat à supprimer.
|
productId |
string
Obligatoire. ID produit du produit ponctuel parent, si toutes les options d'achat à supprimer appartiennent au même produit ponctuel. Si cette suppression groupée concerne plusieurs produits ponctuels, définissez ce champ sur "-".
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Champs |
requests[] |
object (DeletePurchaseOptionRequest )
Obligatoire. Liste de demandes de suppression comportant jusqu'à 100 éléments. Toutes les demandes doivent supprimer les options d'achat de différents produits ponctuels.
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse est un objet JSON vide.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/androidpublisher
DeletePurchaseOptionRequest
Message de requête pour supprimer une option d'achat.
Représentation JSON |
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"latencyTolerance": enum (ProductUpdateLatencyTolerance ),
"force": boolean
} |
Champs |
packageName |
string
Obligatoire. Application parente (nom du package) de l'option d'achat à supprimer.
|
productId |
string
Obligatoire. Produit ponctuel parent (ID) de l'option d'achat à supprimer.
|
purchaseOptionId |
string
Obligatoire. ID de l'option d'achat à supprimer.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
Facultatif. Tolérance à la latence pour la propagation de la mise à jour de ce produit. La valeur par défaut est "sensible à la latence".
|
force |
boolean
Facultatif. Ce champ n'a aucun effet sur les options d'achat sans offre associée. Pour les options d'achat associées à des offres : * Si force est défini sur "false" (valeur par défaut), une erreur est renvoyée. * Si force est défini sur "true", toutes les offres associées à l'option d'achat seront supprimées.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[],[],null,["# Method: monetization.onetimeproducts.purchaseOptions.batchDelete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [DeletePurchaseOptionRequest](#DeletePurchaseOptionRequest)\n - [JSON representation](#DeletePurchaseOptionRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nDeletes purchase options across one or multiple one-time products.\n\nBy default this operation will fail if there are any existing offers under the deleted purchase options. Use the force parameter to override the default behavior.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchDelete`\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) of the purchase options to delete. |\n| `productId` | `string` Required. The product ID of the parent one-time product, if all purchase options to delete belong to the same one-time product. If this batch delete spans multiple one-time products, set this field to \"-\". |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requests\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions/batchDelete#DeletePurchaseOptionRequest) } ] } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[DeletePurchaseOptionRequest](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions/batchDelete#DeletePurchaseOptionRequest)`)` Required. A list of delete requests of up to 100 elements. All requests must delete purchase options from different one-time products. |\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nDeletePurchaseOptionRequest\n---------------------------\n\nRequest message for deleting a purchase option.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"packageName\": string, \"productId\": string, \"purchaseOptionId\": string, \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance), \"force\": boolean } ``` |\n\n| Fields ||\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) of the purchase option to delete. |\n| `productId` | `string` Required. The parent one-time product (ID) of the purchase option to delete. |\n| `purchaseOptionId` | `string` Required. The purchase option ID of the purchase option to delete. |\n| `latencyTolerance` | `enum (`[ProductUpdateLatencyTolerance](/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance)`)` Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive. |\n| `force` | `boolean` Optional. This field has no effect for purchase options with no offers under them. For purchase options with associated offers: \\* If `force` is set to false (default), an error will be returned. \\* If `force` is set to true, any associated offers under the purchase option will be deleted. |"]]