Conversion: getByCustomerId
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 à l'aide d'un nouveau numéro client Search Ads 360.
Essayer maintenant
Requête
Requête HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion
Paramètres
Nom du paramètre |
Valeur |
Description |
Paramètres de chemin d'accès |
customerId |
string |
Nouvelle chaîne de numéro client Search Ads 360. Il doit s'agir d'un compte client.
|
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 la
autonome
l'explorateur de donné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 2024/08/20 (UTC).
[null,null,["Dernière mise à jour le 2024/08/20 (UTC)."],[[["\u003cp\u003eRetrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID.\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 date ranges, result limits, and filtering by ad group, ad, campaign, or criterion IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe response, if successful, returns a Conversion resource.\u003c/p\u003e\n"],["\u003cp\u003eYou can try this method using the provided APIs Explorer or standalone Explorer.\u003c/p\u003e\n"]]],["This outlines how to retrieve conversion data from a Search Ads 360 account. A `GET` request to a specific URL is required, using the customer ID, start and end dates, number of rows, and a start row. Optional parameters allow filtering by ad group, ad, campaign, or criterion IDs. The request needs authorization using a specified scope. A successful request returns a conversion resource, with the response having no request body.\n"],null,["# Conversion: getByCustomerId\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `customerId` | `string` | New search Ads 360 Customer ID String. Must be a client 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.getByCustomerId)."]]