Conversion: updateAvailability
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Met à jour les disponibilités d'un lot d'activités Floodlight dans DoubleClick Search.
Essayer maintenant
Requête
Requête HTTP
POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
Autorisation
Cette requête nécessite une autorisation ayant le champ d'application suivant:
Champ d'application |
https://www.googleapis.com/auth/doubleclicksearch |
Pour en savoir plus, consultez la page Authentification et autorisation.
Corps de la requête
Dans le corps de la requête, fournissez les données selon la structure suivante:
{
"availabilities": [
{
"agencyId": long,
"advertiserId": long,
"customerId": string,
"segmentationType": string,
"segmentationId": long,
"segmentationName": string,
"availabilityTimestamp": unsigned long
}
]
}
Nom de propriété |
Valeur |
Description |
Remarques |
availabilities[] |
list |
Disponibilités demandées. |
|
availabilities[].agencyId |
long |
ID d'agence DS. |
|
availabilities[].advertiserId |
long |
référence annonceur DS. |
|
availabilities[].segmentationType |
string |
Type de segmentation auquel est destinée cette disponibilité (sa valeur par défaut est FLOODLIGHT ).
Les valeurs possibles sont les suivantes:
<ph type="x-smartling-placeholder">
|
|
availabilities[].segmentationId |
long |
Identifiant de segmentation numérique (par exemple, ID d'activité Floodlight DoubleClick Search). |
|
availabilities[].segmentationName |
string |
Identifiant de segmentation convivial (par exemple, le nom d'activité Floodlight DoubleClick Search). |
|
availabilities[].availabilityTimestamp |
unsigned long |
Heure à laquelle toutes les conversions ont été importées, exprimée en epoch (millisecondes UTC). |
|
availabilities[].customerId |
string |
Nouveau numéro client Search Ads 360. Il doit s'agir d'un compte administrateur secondaire. |
|
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{
"availabilities": [
{
"agencyId": long,
"advertiserId": long,
"customerId": string,
"segmentationType": string,
"segmentationId": long,
"segmentationName": string,
"availabilityTimestamp": unsigned long
}
]
}
Nom de propriété |
Valeur |
Description |
Remarques |
availabilities[] |
list |
Disponibilités renvoyées. |
|
availabilities[].agencyId |
long |
ID d'agence DS. |
|
availabilities[].advertiserId |
long |
référence annonceur DS. |
|
availabilities[].segmentationType |
string |
Type de segmentation auquel est destinée cette disponibilité (sa valeur par défaut est FLOODLIGHT ).
Les valeurs possibles sont les suivantes:
<ph type="x-smartling-placeholder">
|
|
availabilities[].segmentationId |
long |
Identifiant de segmentation numérique (par exemple, ID d'activité Floodlight DoubleClick Search). |
|
availabilities[].segmentationName |
string |
Identifiant de segmentation convivial (par exemple, le nom d'activité Floodlight DoubleClick Search). |
|
availabilities[].availabilityTimestamp |
unsigned long |
Heure à laquelle toutes les conversions ont été importées, exprimée en epoch (millisecondes UTC). |
|
availabilities[].customerId |
string |
Nouveau numéro client Search Ads 360. Il doit s'agir d'un compte administrateur secondaire. |
|
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.
Vous pouvez également essayer
autonome
un navigateur Web.
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 2024/08/20 (UTC).
[null,null,["Dernière mise à jour le 2024/08/20 (UTC)."],[[["\u003cp\u003eUpdates the availability status for a batch of floodlight activities in DoubleClick Search.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes an array of \u003ccode\u003eavailabilities\u003c/code\u003e with details like agencyId, advertiserId, segmentation details, and availability timestamp.\u003c/p\u003e\n"],["\u003cp\u003eThe response returns an array of \u003ccode\u003eavailabilities\u003c/code\u003e mirroring the request structure, confirming the updated status.\u003c/p\u003e\n"]]],["This API endpoint, accessed via a POST request to `https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability`, updates the availabilities of multiple floodlight activities in DoubleClick Search. The request body requires authorization and includes a list of `availabilities`. Each entry needs `agencyId`, `advertiserId`, `customerId`, `segmentationType` (default `FLOODLIGHT`), `segmentationId`, `segmentationName`, and `availabilityTimestamp`. The response mirrors the request structure, returning the updated `availabilities` with the same fields.\n"],null,["# Conversion: updateAvailability\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates the availabilities of a batch of floodlight activities in DoubleClick Search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability\n```\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```text\n{\n \"availabilities\": [\n {\n \"agencyId\": long,\n \"advertiserId\": long,\n \"customerId\": string,\n \"segmentationType\": string,\n \"segmentationId\": long,\n \"segmentationName\": string,\n \"availabilityTimestamp\": unsigned long\n }\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|------------------------------------------|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `availabilities[]` | `list` | The availabilities being requested. | |\n| availabilities[].`agencyId` | `long` | DS agency ID. | |\n| availabilities[].`advertiserId` | `long` | DS advertiser ID. | |\n| availabilities[].`segmentationType` | `string` | The segmentation type that this availability is for (its default value is `FLOODLIGHT`). \u003cbr /\u003e Acceptable values are: - \"`FLOODLIGHT`\" | |\n| availabilities[].`segmentationId` | `long` | The numeric segmentation identifier (for example, DoubleClick Search Floodlight activity ID). | |\n| availabilities[].`segmentationName` | `string` | The friendly segmentation identifier (for example, DoubleClick Search Floodlight activity name). | |\n| availabilities[].`availabilityTimestamp` | `unsigned long` | The time by which all conversions have been uploaded, in epoch millis UTC. | |\n| availabilities[].`customerId` | `string` | New Search Ads 360 customer ID. This must be a sub-manager account. | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"availabilities\": [\n {\n \"agencyId\": long,\n \"advertiserId\": long,\n \"customerId\": string,\n \"segmentationType\": string,\n \"segmentationId\": long,\n \"segmentationName\": string,\n \"availabilityTimestamp\": unsigned long\n }\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|------------------------------------------|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `availabilities[]` | `list` | The availabilities being returned. | |\n| availabilities[].`agencyId` | `long` | DS agency ID. | |\n| availabilities[].`advertiserId` | `long` | DS advertiser ID. | |\n| availabilities[].`segmentationType` | `string` | The segmentation type that this availability is for (its default value is `FLOODLIGHT`). \u003cbr /\u003e Acceptable values are: - \"`FLOODLIGHT`\" | |\n| availabilities[].`segmentationId` | `long` | The numeric segmentation identifier (for example, DoubleClick Search Floodlight activity ID). | |\n| availabilities[].`segmentationName` | `string` | The friendly segmentation identifier (for example, DoubleClick Search Floodlight activity name). | |\n| availabilities[].`availabilityTimestamp` | `unsigned long` | The time by which all conversions have been uploaded, in epoch millis UTC. | |\n| availabilities[].`customerId` | `string` | New Search Ads 360 customer ID. This must be a sub-manager account. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.conversion.updateAvailability)."]]