Conversion: get
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Récupère une liste de conversions à partir d'un compte associé à un moteur DoubleClick Search.
Essayer maintenant
Requête
Requête HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion
Paramètres
Nom du paramètre |
Valeur |
Description |
Paramètres de chemin d'accès |
advertiserId |
long |
Référence numérique de l'annonceur.
|
agencyId |
long |
ID numérique de l'agence.
|
engineAccountId |
long |
ID numérique du compte de moteur.
|
Paramètres de requête requis |
endDate |
integer |
Date (incluse) de la période de récupération des conversions. au format aaaammjj.
Les valeurs autorisées vont de 20091101 à 99991231 , inclus.
|
rowCount |
integer |
Nombre de conversions à renvoyer par appel.
Les valeurs autorisées vont de 1 à 1000 , inclus.
|
startDate |
integer |
Date de début (incluse) de la récupération des conversions. au format aaaammjj.
Les valeurs autorisées vont de 20091101 à 99991231 , inclus.
|
startRow |
unsigned integer |
Indice de départ basé sur 0 pour la récupération des résultats de conversion.
|
Paramètres de requête facultatifs |
adGroupId |
long |
ID numérique du groupe d'annonces.
|
adId |
long |
ID numérique de l'annonce.
|
campaignId |
long |
ID numérique de la campagne.
|
criterionId |
long |
ID numérique du critère.
|
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
Ne spécifiez pas de corps de requête pour cette méthode.
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\u003eRetrieves a list of conversions from a specified DoubleClick Search engine account within a given date range.\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\u003eRequest parameters include specifying the agency, advertiser, engine account, date range, and result pagination.\u003c/p\u003e\n"],["\u003cp\u003eOptionally filter conversions by ad group, ad, campaign, or criterion IDs.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides a Conversion resource containing details about the retrieved conversions.\u003c/p\u003e\n"]]],["This method retrieves conversions from a DoubleClick Search engine account. It requires authorization and uses a GET request with specific path and query parameters. Mandatory parameters include `agencyId`, `advertiserId`, `engineAccountId`, `endDate`, `rowCount`, `startDate`, and `startRow`. Optional parameters include `adGroupId`, `adId`, `campaignId`, and `criterionId`. The successful response contains a list of conversion resources. No request body is needed.\n"],null,["# Conversion: get\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves a list of conversions from a DoubleClick Search engine account.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-------------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `advertiserId` | `long` | Numeric ID of the advertiser. |\n| `agencyId` | `long` | Numeric ID of the agency. |\n| `engineAccountId` | `long` | Numeric ID of the engine account. |\n| **Required query parameters** |||\n| `endDate` | `integer` | Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `rowCount` | `integer` | The number of conversions to return per call. Acceptable values are `1` to `1000`, inclusive. |\n| `startDate` | `integer` | First date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `startRow` | `unsigned integer` | The 0-based starting index for retrieving conversions results. |\n| **Optional query parameters** |||\n| `adGroupId` | `long` | Numeric ID of the ad group. |\n| `adId` | `long` | Numeric ID of the ad. |\n| `campaignId` | `long` | Numeric ID of the campaign. |\n| `criterionId` | `long` | Numeric ID of the criterion. |\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\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [Conversion resource](/search-ads/v2/reference/conversion#resource) in the response body.\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.get)."]]