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.

Cette page a été traduite par l'API Cloud Translation.

Package google.ads.searchads360.v0.services

Index

CustomColumnService (interface)
CustomerService (interface)
SearchAds360FieldService (interface)
SearchAds360Service (interface)
ConversionCustomDimensionHeader (message)
ConversionCustomMetricHeader (message)
CustomColumnHeader (message)
GetCustomColumnRequest (message)
GetSearchAds360FieldRequest (message)
ListAccessibleCustomersRequest (message)
ListAccessibleCustomersResponse (message)
ListCustomColumnsRequest (message)
ListCustomColumnsResponse (message)
RawEventConversionDimensionHeader (message)
RawEventConversionMetricHeader (message)
SearchAds360Row (message)
SearchSearchAds360FieldsRequest (message)
SearchSearchAds360FieldsResponse (message)
SearchSearchAds360Request (message)
SearchSearchAds360Response (message)
SearchSearchAds360StreamRequest (message)
SearchSearchAds360StreamResponse (message)

CustomColumnService

Service permettant de gérer les colonnes personnalisées.

GetCustomColumn

GetCustomColumn
`rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)` Renvoie la colonne personnalisée demandée en détail. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/doubleclicksearch`

rpc GetCustomColumn(GetCustomColumnRequest) returns (CustomColumn)

Renvoie la colonne personnalisée demandée en détail.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/doubleclicksearch

ListCustomColumns

ListCustomColumns
`rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)` Renvoie toutes les colonnes personnalisées associées au client en détail. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/doubleclicksearch`

rpc ListCustomColumns(ListCustomColumnsRequest) returns (ListCustomColumnsResponse)

Renvoie toutes les colonnes personnalisées associées au client en détail.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/doubleclicksearch

CustomerService

Service permettant de gérer les clients.

ListAccessibleCustomers

ListAccessibleCustomers
`rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse)` Renvoie les noms de ressources des clients directement accessibles par l'utilisateur qui authentifie l'appel. Liste des erreurs générées : AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/doubleclicksearch`

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse)

Renvoie les noms de ressources des clients directement accessibles par l'utilisateur qui authentifie l'appel.

Liste des erreurs générées : AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/doubleclicksearch

SearchAds360FieldService

Service permettant d'extraire les champs de l'API Search Ads 360.

GetSearchAds360Field

GetSearchAds360Field
`rpc GetSearchAds360Field(GetSearchAds360FieldRequest) returns (SearchAds360Field)` Renvoie uniquement le champ demandé. Liste des erreurs générées : AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/doubleclicksearch`

rpc GetSearchAds360Field(GetSearchAds360FieldRequest) returns (SearchAds360Field)

Renvoie uniquement le champ demandé.

Liste des erreurs générées : AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/doubleclicksearch

SearchSearchAds360Fields

SearchSearchAds360Fields
`rpc SearchSearchAds360Fields(SearchSearchAds360FieldsRequest) returns (SearchSearchAds360FieldsResponse)` Renvoie tous les champs correspondant à la requête de recherche. Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/doubleclicksearch`

rpc SearchSearchAds360Fields(SearchSearchAds360FieldsRequest) returns (SearchSearchAds360FieldsResponse)

Renvoie tous les champs correspondant à la requête de recherche.

Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/doubleclicksearch

SearchAds360Service

Service permettant d'extraire des données et des métriques sur les ressources

Rechercher

Rechercher
`rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response)` Renvoie toutes les lignes correspondant à la requête de recherche. Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/doubleclicksearch`

rpc Search(SearchSearchAds360Request) returns (SearchSearchAds360Response)

Renvoie toutes les lignes correspondant à la requête de recherche.

Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/doubleclicksearch

SearchStream

SearchStream
`rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse)` Renvoie toutes les lignes correspondant à la requête du flux de recherche. Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/doubleclicksearch`

rpc SearchStream(SearchSearchAds360StreamRequest) returns (SearchSearchAds360StreamResponse)

Renvoie toutes les lignes correspondant à la requête du flux de recherche.

Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/doubleclicksearch

ConversionCustomDimensionHeader

Message de l'en-tête de la dimension personnalisée "Conversions".

Champs

Champs
`id`	`int64` ID de la dimension personnalisée de conversion.
`name`	`string` Nom défini par l'utilisateur de la dimension personnalisée de conversion.

id

int64

ID de la dimension personnalisée de conversion.

name

string

Nom défini par l'utilisateur de la dimension personnalisée de conversion.

ConversionCustomMetricHeader

Message pour l'en-tête de métrique personnalisée sur les conversions.

Champs

Champs
`id`	`int64` ID de la métrique personnalisée de conversion.
`name`	`string` Nom défini par l'utilisateur pour la métrique personnalisée de conversion.

id

int64

ID de la métrique personnalisée de conversion.

name

string

Nom défini par l'utilisateur pour la métrique personnalisée de conversion.

CustomColumnHeader

Message pour l'en-tête de la colonne personnalisée.

Champs

Champs
`id`	`int64` ID de la colonne personnalisée.
`name`	`string` Nom défini par l'utilisateur de la colonne personnalisée.
`references_metrics`	`bool` Vrai quand la colonne personnalisée fait référence à des métriques.

id

int64

ID de la colonne personnalisée.

name

string

Nom défini par l'utilisateur de la colonne personnalisée.

references_metrics

bool

Vrai quand la colonne personnalisée fait référence à des métriques.

GetCustomColumnRequest

Message de requête pour CustomColumnService.GetCustomColumn.

Champs

Champs
`resource_name`	`string` Obligatoire. Nom de ressource de la colonne personnalisée à extraire.

resource_name

string

Obligatoire. Nom de ressource de la colonne personnalisée à extraire.

GetSearchAds360FieldRequest

Message de requête pour SearchAds360FieldService.GetSearchAds360Field.

Champs

Champs
`resource_name`	`string` Obligatoire. Nom de la ressource du champ à récupérer.

resource_name

string

Obligatoire. Nom de la ressource du champ à récupérer.

ListAccessibleCustomersRequest

Ce type ne comporte aucun champ.

Message de requête pour CustomerService.ListAccessibleCustomers.

ListAccessibleCustomersResponse

Message de réponse pour CustomerService.ListAccessibleCustomers.

Champs

Champs
`resource_names[]`	`string` Nom de ressource des clients directement accessibles par l'utilisateur qui authentifie l'appel.

resource_names[]

string

Nom de ressource des clients directement accessibles par l'utilisateur qui authentifie l'appel.

ListCustomColumnsRequest

Message de requête pour CustomColumnService.ListCustomColumns

Champs

Champs
`customer_id`	`string` Obligatoire. ID du client auquel appliquer l'opération de liste CustomColumn.

customer_id

string

Obligatoire. ID du client auquel appliquer l'opération de liste CustomColumn.

ListCustomColumnsResponse

Message de réponse pour extraire toutes les colonnes personnalisées associées à un client.

Champs

Champs
`custom_columns[]`	`CustomColumn` Les CustomColumns appartenant au client fourni.

custom_columns[]

CustomColumn

Les CustomColumns appartenant au client fourni.

RawEventConversionDimensionHeader

Message pour l'en-tête de la dimension "Conversion d'événement brut".

Champs

Champs
`id`	`int64` ID de la variable personnalisée de conversion.
`name`	`string` Nom défini par l'utilisateur pour la dimension d'événement brute.

id

int64

ID de la variable personnalisée de conversion.

name

string

Nom défini par l'utilisateur pour la dimension d'événement brute.

RawEventConversionMetricHeader

Message pour l'en-tête de métrique de conversion d'événement brut.

Champs

Champs
`id`	`int64` ID de la variable personnalisée de conversion.
`name`	`string` Nom défini par l'utilisateur pour la métrique d'événement brute.

id

int64

ID de la variable personnalisée de conversion.

name

string

Nom défini par l'utilisateur pour la métrique d'événement brute.

Ligne SearchAds360

Ligne renvoyée par la requête.

Champs
`ad_group`	`AdGroup` Groupe d'annonces référencé dans la requête.
`ad_group_ad`	`AdGroupAd` Annonce référencée dans la requête.
`ad_group_ad_effective_label`	`AdGroupAdEffectiveLabel` Libellé effectif de l'annonce du groupe d'annonces référencé dans la requête.
`ad_group_ad_label`	`AdGroupAdLabel` Libellé de l'annonce du groupe d'annonces référencé dans la requête.
`ad_group_asset`	`AdGroupAsset` Composant du groupe d'annonces référencé dans la requête.
`ad_group_asset_set`	`AdGroupAssetSet` Ensemble d'éléments du groupe d'annonces référencé dans la requête.
`ad_group_audience_view`	`AdGroupAudienceView` Vue de l'audience du groupe d'annonces référencée dans la requête.
`ad_group_bid_modifier`	`AdGroupBidModifier` Modificateur d'enchères référencé dans la requête.
`ad_group_criterion`	`AdGroupCriterion` Critère référencé dans la requête.
`ad_group_criterion_effective_label`	`AdGroupCriterionEffectiveLabel` Libellé effectif du critère de groupe d'annonces référencé dans la requête.
`ad_group_criterion_label`	`AdGroupCriterionLabel` Libellé du critère du groupe d'annonces référencé dans la requête.
`ad_group_effective_label`	`AdGroupEffectiveLabel` Libellé effectif du groupe d'annonces référencé dans la requête.
`ad_group_label`	`AdGroupLabel` Libellé du groupe d'annonces référencé dans la requête.
`age_range_view`	`AgeRangeView` Vue de la tranche d'âge référencée dans la requête.
`asset`	`Asset` L'asset référencé dans la requête.
`asset_group_asset`	`AssetGroupAsset` Composant du groupe de composants référencé dans la requête.
`asset_group_signal`	`AssetGroupSignal` Signal du groupe d'éléments référencé dans la requête.
`asset_group_listing_group_filter`	`AssetGroupListingGroupFilter` Filtre de groupe de fiches de groupe d'assets référencé dans la requête.
`asset_group_top_combination_view`	`AssetGroupTopCombinationView` Vue de la combinaison de composants la plus performante du groupe de composants référencée dans la requête.
`asset_group`	`AssetGroup` Groupe d'assets référencé dans la requête.
`asset_set_asset`	`AssetSetAsset` Asset de l'ensemble d'assets référencé dans la requête.
`asset_set`	`AssetSet` Ensemble d'assets référencé dans la requête.
`bidding_strategy`	`BiddingStrategy` Stratégie d'enchères référencée dans la requête.
`campaign_budget`	`CampaignBudget` Budget de la campagne référencé dans la requête.
`campaign`	`Campaign` Campagne référencée dans la requête.
`campaign_asset`	`CampaignAsset` Composant de la campagne référencé dans la requête.
`campaign_asset_set`	`CampaignAssetSet` Ensemble de composants de la campagne référencé dans la requête.
`campaign_audience_view`	`CampaignAudienceView` Vue de l'audience de la campagne référencée dans la requête.
`campaign_criterion`	`CampaignCriterion` Critère de campagne référencé dans la requête.
`campaign_effective_label`	`CampaignEffectiveLabel` Libellé de la campagne effective référencé dans la requête.
`campaign_label`	`CampaignLabel` Libellé de la campagne référencé dans la requête.
`cart_data_sales_view`	`CartDataSalesView` Vue des ventes des données du panier référencée dans la requête.
`audience`	`Audience` Audience référencée dans la requête.
`conversion_action`	`ConversionAction` Action de conversion référencée dans la requête.
`conversion_custom_variable`	`ConversionCustomVariable` Variable personnalisée de conversion référencée dans la requête.
`customer`	`Customer` Client référencé dans la requête.
`customer_asset`	`CustomerAsset` Élément client référencé dans la requête.
`customer_asset_set`	`CustomerAssetSet` Ensemble d'assets client référencé dans la requête.
`accessible_bidding_strategy`	`AccessibleBiddingStrategy` Stratégie d'enchères accessible référencée dans la requête.
`customer_manager_link`	`CustomerManagerLink` CustomerManagerLink référencé dans la requête.
`customer_client`	`CustomerClient` CustomerClient référencé dans la requête.
`dynamic_search_ads_search_term_view`	`DynamicSearchAdsSearchTermView` Vue des termes de recherche des annonces dynamiques du Réseau de Recherche référencée dans la requête.
`gender_view`	`GenderView` Vue sur le genre référencée dans la requête.
`geo_target_constant`	`GeoTargetConstant` Constante de ciblage géographique référencée dans la requête.
`keyword_view`	`KeywordView` Vue des mots clés référencée dans la requête.
`label`	`Label` Libellé référencé dans la requête.
`language_constant`	`LanguageConstant` Constante de langage référencée dans la requête.
`location_view`	`LocationView` Vue de l'emplacement référencée dans la requête.
`product_bidding_category_constant`	`ProductBiddingCategoryConstant` Catégorie d'enchères sur les produits référencée dans la requête.
`product_group_view`	`ProductGroupView` Vue du groupe de produits référencée dans la requête.
`shopping_performance_view`	`ShoppingPerformanceView` Vue des performances Shopping référencée dans la requête.
`user_list`	`UserList` Liste d'utilisateurs référencée dans la requête.
`user_location_view`	`UserLocationView` Vue de l'emplacement de l'utilisateur référencée dans la requête.
`webpage_view`	`WebpageView` Vue de la page Web référencée dans la requête.
`visit`	`Visit` Visite au niveau de l'événement référencée dans la requête.
`conversion`	`Conversion` Conversion au niveau de l'événement référencée dans la requête.
`metrics`	`Metrics` Les métriques
`segments`	`Segments` Les segments.
`custom_columns[]`	`Value` Colonnes personnalisées.

SearchSearchAds360FieldsRequest

Message de requête pour SearchAds360FieldService.SearchSearchAds360Fields.

Champs

Champs
`query`	`string` Obligatoire. Chaîne de requête.
`page_token`	`string` Jeton de la page à récupérer. Si cette valeur n'est pas spécifiée, la première page de résultats est renvoyée. Utilisez la valeur obtenue à partir de `next_page_token` dans la réponse précédente pour demander la page de résultats suivante.
`page_size`	`int32` Nombre d'éléments à récupérer sur une seule page. Lorsqu'une page trop volumineuse est demandée, le serveur peut décider de limiter davantage le nombre de ressources renvoyées.

query

string

Obligatoire. Chaîne de requête.

page_token

string

Jeton de la page à récupérer. Si cette valeur n'est pas spécifiée, la première page de résultats est renvoyée. Utilisez la valeur obtenue à partir de next_page_token dans la réponse précédente pour demander la page de résultats suivante.

page_size

int32

Nombre d'éléments à récupérer sur une seule page. Lorsqu'une page trop volumineuse est demandée, le serveur peut décider de limiter davantage le nombre de ressources renvoyées.

SearchSearchAds360FieldsResponse

Message de réponse pour SearchAds360FieldService.SearchSearchAds360Fields.

Champs

Champs
`results[]`	`SearchAds360Field` Liste des champs correspondant à la requête.
`next_page_token`	`string` Jeton de pagination utilisé pour récupérer la page de résultats suivante. Transmettez le contenu de cette chaîne en tant qu'attribut `page_token` de la requête suivante. `next_page_token` n'est pas renvoyé pour la dernière page.
`total_results_count`	`int64` Nombre total de résultats correspondant à la requête, en ignorant la clause LIMIT.

results[]

SearchAds360Field

Liste des champs correspondant à la requête.

next_page_token

string

Jeton de pagination utilisé pour récupérer la page de résultats suivante. Transmettez le contenu de cette chaîne en tant qu'attribut page_token de la requête suivante. next_page_token n'est pas renvoyé pour la dernière page.

total_results_count

int64

Nombre total de résultats correspondant à la requête, en ignorant la clause LIMIT.

SearchSearchAds360Request

Message de requête pour SearchAds360Service.Search.

Champs
`customer_id`	`string` Obligatoire. ID du client faisant l'objet de la requête.
`query`	`string` Obligatoire. Chaîne de requête.
`page_token`	`string` Jeton de la page à récupérer. Si cette valeur n'est pas spécifiée, la première page de résultats est renvoyée. Utilisez la valeur obtenue à partir de `next_page_token` dans la réponse précédente pour demander la page de résultats suivante.
`page_size`	`int32` Nombre d'éléments à récupérer sur une seule page. Lorsqu'une page trop volumineuse est demandée, le serveur peut décider de limiter davantage le nombre de ressources renvoyées.
`validate_only`	`bool` Si la valeur est "true", la requête est validée, mais pas exécutée.
`return_total_results_count`	`bool` Si cette valeur est définie sur "true", le nombre total de résultats correspondant à la requête en ignorant la clause LIMIT est inclus dans la réponse. La valeur par défaut est "false".
`summary_row_setting`	`SummaryRowSetting` Détermine si une ligne récapitulative est renvoyée. Par défaut, la ligne récapitulative n'est pas renvoyée. Si vous le demandez, la ligne récapitulative sera envoyée seule dans une réponse une fois tous les autres résultats de la requête renvoyés.

SearchSearchAds360Response

Message de réponse pour SearchAds360Service.Search.

Champs
`results[]`	`SearchAds360Row` Liste des lignes correspondant à la requête.
`next_page_token`	`string` Jeton de pagination utilisé pour récupérer la page suivante des résultats. Transmettez le contenu de cette chaîne en tant qu'attribut `page_token` de la requête suivante. `next_page_token` n'est pas renvoyé pour la dernière page.
`total_results_count`	`int64` Nombre total de résultats correspondant à la requête (en ignorant la clause LIMIT).
`field_mask`	`FieldMask` FieldMask qui représente les champs demandés par l'utilisateur.
`summary_row`	`SearchAds360Row` Ligne récapitulative contenant un résumé des métriques dans les résultats. Le résumé des métriques signifie l'agrégation des métriques pour l'ensemble des résultats. L'agrégation peut être la somme, la moyenne, le taux, etc.
`custom_column_headers[]`	`CustomColumnHeader` En-têtes des colonnes personnalisées dans les résultats.
`conversion_custom_metric_headers[]`	`ConversionCustomMetricHeader` En-têtes des métriques personnalisées de conversion dans les résultats.
`conversion_custom_dimension_headers[]`	`ConversionCustomDimensionHeader` En-têtes des dimensions personnalisées de conversion dans les résultats.
`raw_event_conversion_metric_headers[]`	`RawEventConversionMetricHeader` En-têtes des métriques brutes de conversion d'événements dans les résultats.
`raw_event_conversion_dimension_headers[]`	`RawEventConversionDimensionHeader` En-têtes des dimensions de conversion d'événement brutes dans les résultats.

SearchSearchAds360StreamRequest

Message de requête pour SearchAds360Service.SearchStream.

Champs
`customer_id`	`string` Obligatoire. ID du client faisant l'objet de la requête.
`query`	`string` Obligatoire. Chaîne de requête.
`batch_size`	`int32` Nombre de lignes renvoyées dans chaque lot de réponse de flux. Lorsque le lot demandé est trop volumineux, le serveur peut décider de limiter davantage le nombre de lignes renvoyées.
`summary_row_setting`	`SummaryRowSetting` Détermine si une ligne récapitulative est renvoyée. Par défaut, la ligne récapitulative n'est pas renvoyée. Si vous le demandez, la ligne récapitulative sera envoyée seule dans une réponse une fois tous les autres résultats de la requête renvoyés.

SearchSearchAds360StreamResponse

Message de réponse pour SearchAds360Service.SearchStream.

Champs
`results[]`	`SearchAds360Row` Liste des lignes correspondant à la requête.
`field_mask`	`FieldMask` FieldMask qui représente les champs demandés par l'utilisateur.
`summary_row`	`SearchAds360Row` Ligne récapitulative contenant un résumé des métriques dans les résultats. Le résumé des métriques signifie l'agrégation des métriques pour l'ensemble des résultats. L'agrégation peut être la somme, la moyenne, le taux, etc.
`custom_column_headers[]`	`CustomColumnHeader` En-têtes des colonnes personnalisées dans les résultats.
`conversion_custom_metric_headers[]`	`ConversionCustomMetricHeader` En-têtes des métriques personnalisées de conversion dans les résultats.
`conversion_custom_dimension_headers[]`	`ConversionCustomDimensionHeader` En-têtes de la dimension personnalisée de conversion dans les résultats.
`raw_event_conversion_metric_headers[]`	`RawEventConversionMetricHeader` En-têtes des métriques brutes de conversion d'événements dans les résultats.
`raw_event_conversion_dimension_headers[]`	`RawEventConversionDimensionHeader` En-têtes des dimensions de conversion d'événement brutes dans les résultats.
`request_id`	`string` ID unique de la requête utilisé à des fins de débogage.