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.

composant

L'asset est une partie d'une annonce qui peut être partagée entre plusieurs annonces. Il peut s'agir d'une image (ImageAsset), d'une vidéo (YouTubeVideoAsset), etc. Les assets sont immuables et ne peuvent pas être supprimés. Pour arrêter la diffusion d'un composant, supprimez-le de l'entité qui l'utilise.

Ressources attribuées
clientèle

Les champs des ressources ci-dessus peuvent être sélectionnés avec cette ressource dans vos clauses SELECT et WHERE. Ces champs ne segmentent pas les métriques dans votre clause SELECT.

asset.call_asset.ad_schedule_targets
Description du champ	Liste des calendriers qui ne se chevauchent pas, spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Jusqu'à 6 programmations par jour (42 au total).
Catégorie	`ATTRIBUTE`
Type de données	`MESSAGE`
Saisir une URL	`google.ads.searchads360.v0.common.AdScheduleInfo`
Filtrable	Faux
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

asset.call_asset.call_conversion_action
Description du champ	Action de conversion à laquelle attribuer une conversion par appel. Si cette règle n'est pas configurée, l'action de conversion par défaut est utilisée. Ce champ n'a d'effet que si "call_conversion_reporting_state" est défini sur "USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION".
Catégorie	`ATTRIBUTE`
Type de données	`RESOURCE_NAME`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.call_asset.call_conversion_reporting_state
Description du champ	Indique si ce composant Appel doit utiliser son propre paramètre de conversion par appel, suivre le paramètre au niveau du compte ou désactiver la conversion par appel.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM DISABLED UNKNOWN UNSPECIFIED USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION`
Saisir une URL	`google.ads.searchads360.v0.enums.CallConversionReportingStateEnum.CallConversionReportingState`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.call_asset.call_only
Description du champ	Indique si l'appel affiche uniquement le numéro de téléphone, sans lien vers le site Web. S'applique aux annonces Microsoft.
Catégorie	`ATTRIBUTE`
Type de données	`BOOLEAN`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.call_asset.call_tracking_enabled
Description du champ	Indique si l'appel doit être activé pour le suivi des appels. S'applique aux annonces Microsoft.
Catégorie	`ATTRIBUTE`
Type de données	`BOOLEAN`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.call_asset.country_code
Description du champ	Code pays à deux lettres correspondant au numéro de téléphone. Exemples: "US", "us".
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.call_asset.end_date
Description du champ	Date limite à laquelle ce composant est effectif et est toujours diffusé, au format aaaa-MM-jj.
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.call_asset.phone_number
Description du champ	Numéro de téléphone brut de l'annonceur. Exemples: "1234567890", "(123)456-7890"
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.call_asset.start_date
Description du champ	Date de début d'entrée en vigueur de ce composant et de début de diffusion, au format aaaa-MM-jj.
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.call_asset.use_searcher_time_zone
Description du champ	Indique si l'extension d'appel doit s'afficher dans le fuseau horaire de l'utilisateur de la recherche. S'applique aux annonces Microsoft.
Catégorie	`ATTRIBUTE`
Type de données	`BOOLEAN`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.call_to_action_asset.call_to_action
Description du champ	Incitation à l'action.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM APPLY_NOW BOOK_NOW BUY_NOW CONTACT_US DONATE_NOW DOWNLOAD GET_QUOTE LEARN_MORE ORDER_NOW PLAY_NOW SEE_MORE SHOP_NOW SIGN_UP START_NOW SUBSCRIBE UNKNOWN UNSPECIFIED VISIT_SITE WATCH_NOW`
Saisir une URL	`google.ads.searchads360.v0.enums.CallToActionTypeEnum.CallToActionType`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.callout_asset.ad_schedule_targets
Description du champ	Liste des calendriers qui ne se chevauchent pas, spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Jusqu'à 6 programmations par jour (42 au total).
Catégorie	`ATTRIBUTE`
Type de données	`MESSAGE`
Saisir une URL	`google.ads.searchads360.v0.common.AdScheduleInfo`
Filtrable	Faux
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

asset.callout_asset.callout_text
Description du champ	Texte de l'accroche. La longueur de cette chaîne doit être comprise entre 1 et 25, inclus.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.callout_asset.end_date
Description du champ	Date limite à laquelle ce composant est effectif et est toujours diffusé, au format aaaa-MM-jj.
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.callout_asset.start_date
Description du champ	Date de début d'entrée en vigueur de ce composant et de début de diffusion, au format aaaa-MM-jj.
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.callout_asset.use_searcher_time_zone
Description du champ	Indique si l'asset doit être affiché dans le fuseau horaire de l'utilisateur de la recherche. S'applique aux annonces Microsoft.
Catégorie	`ATTRIBUTE`
Type de données	`BOOLEAN`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.creation_time
Description du champ	Horodatage lors de la création de cette annonce. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.engine_status
Description du champ	État dans le moteur d'un élément.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM DISABLED DISAPPROVED REMOVED SERVING SERVING_LIMITED UNKNOWN UNSPECIFIED`
Saisir une URL	`google.ads.searchads360.v0.enums.AssetEngineStatusEnum.AssetEngineStatus`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.final_urls
Description du champ	Liste des URL finales possibles après toutes les redirections interdomaines.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

asset.id
Description du champ	ID de l'élément.
Catégorie	`ATTRIBUTE`
Type de données	`INT64`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.image_asset.file_size
Description du champ	Taille du fichier du composant Image en octets.
Catégorie	`ATTRIBUTE`
Type de données	`INT64`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.image_asset.full_size.height_pixels
Description du champ	Hauteur de l'image.
Catégorie	`ATTRIBUTE`
Type de données	`INT64`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.image_asset.full_size.url
Description du champ	URL qui renvoie l'image avec cette hauteur et cette largeur.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.image_asset.full_size.width_pixels
Description du champ	Largeur de l'image.
Catégorie	`ATTRIBUTE`
Type de données	`INT64`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.image_asset.mime_type
Description du champ	Type MIME du composant Image.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM AUDIO_MP3 AUDIO_WAV FLASH HTML5_AD_ZIP IMAGE_GIF IMAGE_JPEG IMAGE_PNG MSEXCEL MSWORD PDF RTF TEXT_HTML UNKNOWN UNSPECIFIED`
Saisir une URL	`google.ads.searchads360.v0.enums.MimeTypeEnum.MimeType`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.last_modified_time
Description du champ	Date et heure de la dernière modification de cet élément. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.location_asset.business_profile_locations
Description du champ	Liste des établissements du client. Il ne sera renvoyé que si le composant Lieu est synchronisé à partir du compte de la fiche d'établissement. Il est possible que plusieurs fiches d'établissement d'un même compte pointent vers le même ID de lieu.
Catégorie	`ATTRIBUTE`
Type de données	`MESSAGE`
Saisir une URL	`google.ads.searchads360.v0.common.BusinessProfileLocation`
Filtrable	Faux
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

asset.location_asset.location_ownership_type
Description du champ	Type de propriété de l'établissement. Si le type est "BUSINESS_OWNER", l'URL sera diffusée en tant qu'extension de lieu. Si le type est AFFILIATE, il sera diffusé en tant que lieu affilié.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM AFFILIATE BUSINESS_OWNER UNKNOWN UNSPECIFIED`
Saisir une URL	`google.ads.searchads360.v0.enums.LocationOwnershipTypeEnum.LocationOwnershipType`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.location_asset.place_id
Description du champ	Les ID de lieu identifient de façon unique un lieu dans la base de données Google Places et sur Google Maps. Ce champ est unique pour un numéro client et un type de composant donnés. Pour en savoir plus sur les identifiants de lieu, consultez la page https://developers.google.com/places/web-service/place-id.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.mobile_app_asset.app_id
Description du champ	Obligatoire. Chaîne identifiant une application mobile de manière unique. Il doit simplement contenir l'ID natif de la plate-forme, comme "com.android.ebay" pour Android ou "12345689" pour iOS.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.mobile_app_asset.app_store
Description du champ	Obligatoire. Plate-forme de téléchargement d'applications qui distribue cette application spécifique.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM APPLE_APP_STORE GOOGLE_APP_STORE UNKNOWN UNSPECIFIED`
Saisir une URL	`google.ads.searchads360.v0.enums.MobileAppVendorEnum.MobileAppVendor`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.name
Description du champ	Nom facultatif de l'élément.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.page_feed_asset.labels
Description du champ	Libellés utilisés pour regrouper les URL des pages.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

asset.page_feed_asset.page_url
Description du champ	Page Web que les annonceurs souhaitent cibler.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.resource_name
Description du champ	Nom de ressource de l'élément. Les noms de ressources d'asset présentent le format suivant: `customers/{customer_id}/assets/{asset_id}`
Catégorie	`ATTRIBUTE`
Type de données	`RESOURCE_NAME`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Faux

asset.sitelink_asset.ad_schedule_targets
Description du champ	Liste des calendriers qui ne se chevauchent pas, spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Jusqu'à 6 programmations par jour (42 au total).
Catégorie	`ATTRIBUTE`
Type de données	`MESSAGE`
Saisir une URL	`google.ads.searchads360.v0.common.AdScheduleInfo`
Filtrable	Faux
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

asset.sitelink_asset.description1
Description du champ	Première ligne de la description du lien annexe. Si ce paramètre est défini, la longueur doit être comprise entre 1 et 35 inclus, et la valeur description2 doit également être définie.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.sitelink_asset.description2
Description du champ	Deuxième ligne de description du lien annexe. Si ce paramètre est défini, la longueur doit être comprise entre 1 et 35 inclus, et la valeur description1 doit également être définie.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.sitelink_asset.end_date
Description du champ	Date limite à laquelle ce composant est effectif et est toujours diffusé, au format aaaa-MM-jj.
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.sitelink_asset.link_text
Description du champ	Texte à afficher pour le lien annexe. La longueur de cette chaîne doit être comprise entre 1 et 25, inclus.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.sitelink_asset.mobile_preferred
Description du champ	Indique si vous préférez que le composant Lien annexe s'affiche sur les appareils mobiles. S'applique aux annonces Microsoft.
Catégorie	`ATTRIBUTE`
Type de données	`BOOLEAN`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.sitelink_asset.start_date
Description du champ	Date de début d'entrée en vigueur de ce composant et de début de diffusion, au format aaaa-MM-jj.
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.sitelink_asset.tracking_id
Description du champ	ID utilisé pour suivre les clics du composant Lien annexe. Il s'agit d'un compte Yahoo! Japan uniquement.
Catégorie	`ATTRIBUTE`
Type de données	`INT64`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.sitelink_asset.use_searcher_time_zone
Description du champ	Indique si le composant Lien annexe doit être affiché dans le fuseau horaire de l'utilisateur du Réseau de Recherche. S'applique aux annonces Microsoft.
Catégorie	`ATTRIBUTE`
Type de données	`BOOLEAN`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.status
Description du champ	État de l'élément.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM ARCHIVED ENABLED PENDING_SYSTEM_GENERATED REMOVED UNKNOWN UNSPECIFIED`
Saisir une URL	`google.ads.searchads360.v0.enums.AssetStatusEnum.AssetStatus`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.text_asset.text
Description du champ	Contenu textuel de l'asset texte.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.tracking_url_template
Description du champ	Modèle d'URL permettant de créer une URL de suivi.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.type
Description du champ	Type de l'asset.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM BOOK_ON_GOOGLE CALL CALLOUT CALL_TO_ACTION DISCOVERY_CAROUSEL_CARD DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHTS DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_JOBS DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL HOTEL_CALLOUT HOTEL_PROPERTY IMAGE LEAD_FORM LOCATION MEDIA_BUNDLE MOBILE_APP PAGE_FEED PRICE PROMOTION SITELINK STRUCTURED_SNIPPET TEXT UNKNOWN UNSPECIFIED YOUTUBE_VIDEO`
Saisir une URL	`google.ads.searchads360.v0.enums.AssetTypeEnum.AssetType`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.youtube_video_asset.youtube_video_id
Description du champ	ID vidéo YouTube Il s'agit de la valeur de chaîne de 11 caractères utilisée dans l'URL de la vidéo YouTube.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

asset.youtube_video_asset.youtube_video_title
Description du champ	Titre de la vidéo YouTube.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisir une URL	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

composant

asset.call_asset.ad_schedule_targets

asset.call_asset.call_conversion_action

asset.call_asset.call_conversion_reporting_state

asset.call_asset.call_only

asset.call_asset.call_tracking_enabled

asset.call_asset.country_code

asset.call_asset.end_date

asset.call_asset.phone_number

asset.call_asset.start_date

asset.call_asset.use_searcher_time_zone

asset.call_to_action_asset.call_to_action

asset.callout_asset.ad_schedule_targets

asset.callout_asset.callout_text

asset.callout_asset.end_date

asset.callout_asset.start_date

asset.callout_asset.use_searcher_time_zone

asset.creation_time

asset.engine_status

asset.final_urls

asset.id

asset.image_asset.file_size

asset.image_asset.full_size.height_pixels

asset.image_asset.full_size.url

asset.image_asset.full_size.width_pixels

asset.image_asset.mime_type

asset.last_modified_time

asset.location_asset.business_profile_locations

asset.location_asset.location_ownership_type

asset.location_asset.place_id

asset.mobile_app_asset.app_id

asset.mobile_app_asset.app_store

asset.name

asset.page_feed_asset.labels

asset.page_feed_asset.page_url

asset.resource_name

asset.sitelink_asset.ad_schedule_targets

asset.sitelink_asset.description1

asset.sitelink_asset.description2

asset.sitelink_asset.end_date

asset.sitelink_asset.link_text

asset.sitelink_asset.mobile_preferred

asset.sitelink_asset.start_date

asset.sitelink_asset.tracking_id

asset.sitelink_asset.use_searcher_time_zone

asset.status

asset.text_asset.text

asset.tracking_url_template

asset.type

asset.youtube_video_asset.youtube_video_id

asset.youtube_video_asset.youtube_video_title