La nouvelle API Search Ads 360 Reporting est désormais disponible. Rejoignez le groupe Google
searchads-api-announcements pour vous tenir informé des améliorations et versions à venir.
Formats dans l'API Search Ads 360 Reporting
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Le format de la requête dépend du type de requête que vous envoyez.
Rechercher
Vous pouvez personnaliser les résultats de recherche en définissant une requête de recherche adaptée à vos besoins. Le langage de requête Search Ads 360 vous permet de rechercher dans toutes les ressources une liste d'entités correspondant à un ensemble de critères spécifique. Toutes les requêtes, quel que soit le type d'entité, sont effectuées sur SearchAds360Service. Pour en savoir plus, consultez Créer des rapports sur les recherches et Langage de requête Search Ads 360.
Les champs renseignés dans la réponse dépendent du service que vous utilisez:
SearchAds360Service- La réponse inclut un objet
SearchAds360Row pour chaque entité correspondant à vos paramètres de recherche. Chaque ligne contient un objet (par exemple, une campagne) et n'inclut que les champs que vous demandez dans votre requête.
- Services spécifiques
- Vous ne pouvez demander qu'une seule entité à la fois par nom de ressource. La réponse inclut tous les champs de cette entité.
Dans la nouvelle API, vous devez spécifier votre numéro client sous la forme d'un nombre à 10 chiffres (XXXXXXXXXX) sans tirets.
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/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eSearch Ads 360 API request formats vary depending on whether you're searching or requesting specific entities.\u003c/p\u003e\n"],["\u003cp\u003eSearches utilize the Search Ads 360 Query Language and the \u003ccode\u003eSearchAds360Service\u003c/code\u003e for customized results.\u003c/p\u003e\n"],["\u003cp\u003eResponses from \u003ccode\u003eSearchAds360Service\u003c/code\u003e include a \u003ccode\u003eSearchAds360Row\u003c/code\u003e for each matching entity, containing only the requested fields.\u003c/p\u003e\n"],["\u003cp\u003eRequests for specific entities return all fields for that entity, and customer IDs must be provided as 10-digit numbers without dashes.\u003c/p\u003e\n"]]],["Search requests utilize the Search Ads 360 Query Language against the `SearchAds360Service` to retrieve entities matching specific criteria. Responses from `SearchAds360Service` return `SearchAds360Row` objects, including only requested fields. Specific service requests retrieve one entity by resource name, returning all its fields. The Customer ID in the API must be a 10-digit number without dashes. The user can use the \"Create search reports\" or \"Search Ads 360 Query Language\" to learn more.\n"],null,["# Formats in the Search Ads 360 Reporting API\n\nRequest format\n--------------\n\nThe request format depends on the type of request you make.\n\n### Search\n\nYou can customize your search output by defining a search query\nto suit your needs. The Search Ads 360 Query Language allows you to search all\nresources for a list of entities that match a specific set of criteria. All\nrequests, regardless of the entity type, are made against the\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service). See [Create search reports](/search-ads/reporting/concepts/search-reports) and\n[Search Ads 360 Query Language](/search-ads/reporting/query/query-language)\nto learn more.\n\nResponse format\n---------------\n\nThe fields populated in the response depend on the service you use:\n\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service)\n: The response includes one [`SearchAds360Row`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360row) object for each entity that\n matches your search parameters. Each row contains one object, for example, a\n campaign, and includes *only* the fields you request in your query.\n\nSpecific services\n: You can only request one entity at a time by resource name. The response\n includes *all* fields for that entity.\n\nCustomer ID format\n------------------\n\nIn the new API, you must specify your Customer ID as a 10-digit number\n(`XXXXXXXXXX`) without dashes."]]
