L'ancienne API Search Ads 360 Reporting est en cours de suppression. Vous pouvez désormais créer vos rapports à l'aide de la nouvelle API Search Ads 360 Reporting.

Notez que l'API de conversion Search Ads 360 n'est pas concernée et continuera d'être prise en charge.

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

Dépannage

Si vous rencontrez des problèmes lors de l'utilisation de l'API Search Ads 360, consultez cette section de dépannage.

Si vous ne parvenez pas à résoudre un problème après avoir consulté les ressources de ce site, contactez l'assistance et munissez-vous des informations suivantes:

ID de l'agence Search Ads 360 et ID de l'annonceur auxquels vous essayez d'accéder
Numéro de projet dans la console Google APIs
Le nom d'utilisateur du compte Google que vous utilisez pour accéder à l'API
Il s'agit du compte autorisé à accéder à Search Ads 360. Il s'agit du compte que vous utilisez pour configurer les autorisations.
Extrait de code de votre requête
Réponse JSON
Si la réponse est une erreur, veillez à inclure le message d'erreur, et non seulement le code d'erreur numérique.

Erreurs d'autorisation

Voici quelques erreurs d'autorisation couramment rencontrées:

Message	Description
`Access Not Configured. Please use Google API Console to activate the API for your project.`	Cette erreur se produit si vous n'avez pas activé l'API Search Ads 360 pour votre compte. Assurez-vous d'avoir effectué les opérations suivantes: Accédez à la console Google APIs. Sélectionnez votre projet. Si vous n'avez pas encore créé de projet, consultez Créer un projet pour votre client. Dans la barre latérale de gauche, développez API et authentification. Cliquez ensuite sur API. Dans la liste des API, assurez-vous que l'état est ON pour l'API Search Ads 360.
`Invalid grant`	Cette erreur se produit lorsque votre jeton d'actualisation n'est pas valide. Vous pouvez obtenir un jeton d'actualisation en appelant le script d'utilitaire Search Ads 360 comme suit: `sa360Api.py --login` En savoir plus sur le workflow recommandé pour l'autorisation.
`Invalid client no application name`	Cette erreur se produit si vous n'avez pas spécifié de nom de produit lors de la configuration de votre projet dans la console Google APIs. Pour corriger cette erreur, saisissez le nom de votre produit sur l'écran de consentement de la console Google APIs.
Autres types d'erreurs d'autorisation	Veillez à utiliser un compte Google auquel a été accordé l'accès à Search Ads 360 lorsque vous vous connectez à la console Google API pour récupérer votre ID client et votre secret client, et lorsque vous obtenez un jeton d'actualisation.

Erreurs d'importation des conversions

Le tableau suivant répertorie les erreurs que vous pouvez rencontrer lorsque vous importez des conversions. Notez que les codes d'erreur hexadécimaux sont immuables. Vous pouvez donc les utiliser dans vos propres scripts pour identifier les erreurs.

Code d'erreur	Message	Description
`0x00000101`	`Click ID '{ID}' is not found`	L' ID de clic que vous avez spécifié dans une requête `update` n'est pas valide. Réimportez les conversions après avoir effectué les opérations suivantes: Vérification que l'ID de clic a été généré quatre heures avant l'importation des conversions. activé le service de conversion de l'API ; Si vous attribuez des conversions à des visites spécifiques, attendez au moins 30 minutes avant d'importer la conversion. Il est possible que Search Ads 360 ne reconnaisse pas l'ID de clic de la visite si vous effectuez l'importation moins de 30 minutes après la visite. Dans de rares cas, vous devrez peut-être attendre jusqu'à quatre heures avant que Search Ads 360 ne reconnaisse l'ID de clic. Vous avez confirmé que le clic provient d'une source valide, comme indiqué par le paramètre `gclsrc`. Vous avez vérifié que vous avez spécifié l'annonceur approprié dans la colonne advertiserId. Vérifier que votre ID de clic a été généré au cours des 90 derniers jours
`0x0000010E`	`Floodlight activity name '{name}' is not found`	Le nom de l'activité Floodlight spécifié dans la colonne `segmentationName` est incorrect ou n'est pas encore disponible. Si vous rencontrez cette erreur, recherchez les problèmes courants suivants: Les noms sont sensibles à la casse. Assurez-vous donc que votre demande correspond exactement à la casse. Assurez-vous de ne pas avoir inclus de caractères Unicode non imprimables ni d'espaces doubles dans le nom de l'activité Floodlight. Vérifiez que vous avez indiqué le nom d'une activité Floodlight, et non d'une colonne Floodlight. Vérifiez que l'activité Floodlight existe pour l'annonceur que vous avez spécifié dans la colonne `advertiserId`. (Il est possible que vous ayez spécifié le mauvais annonceur.) Lorsque vous créez ou modifiez une activité Floodlight, patientez quelques heures avant d'importer des conversions pour cette activité.
`0x00000115`	`Custom dimension '{name}' is not found`	Assurez-vous que la variable Floodlight personnalisée que vous avez spécifiée a été configurée en tant que dimension (et non métrique) pour l'annonceur associé aux `clickId`, `criterionId` ou `productGroupId` que vous attribuez à la conversion.
`0x00000116`	`Custom metric '{name}' is not found`	Assurez-vous que la variable Floodlight personnalisée que vous avez spécifiée a été configurée en tant que métrique (et non en tant que dimension) pour l'annonceur associé aux `clickId`, `criterionId` ou `productGroupId` que vous attribuez à la conversion.
`0x0000011A`	`The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}`	Une conversion a déjà été importée pour la même portée et le même ID de conversion d'annonceur spécifiés dans la colonne `conversionId`. L'ID de conversion de l'annonceur est un ID que vous générez. Search Ads 360 requiert que cet ID soit unique pour un champ d'application donné. L' ID de conversion Search Ads 360 est généré par Search Ads 360 et est garanti comme étant unique.
`0x0000011B`	`Advertiser conversion ID '{ID}' is not found`	Votre requête `update` a tenté de mettre à jour un ID de conversion d'annonceur qui n'existe pas. Assurez-vous d'avoir indiqué le bon ID.
`0x0000011D`	`User does not have permission to view advertiser {advertiser ID}`	Le compte Google que votre client utilise n'est pas autorisé à afficher l'annonceur spécifié dans la demande. Lorsque vous vous connectez à la console Google APIs pour récupérer votre ID client et votre secret client, et lorsque vous obtenez un jeton d'actualisation, assurez-vous d'utiliser un compte Google auquel l'accès a été accordé à l'annonceur que vous avez spécifié.
`0x0000011F`	`Advertiser conversion ID is already specified in this request`	Au moins deux conversions dans la demande spécifient le même champ d'application et le même ID de conversion d'annonceur. L'ID de conversion de l'annonceur est un ID que vous générez et spécifiez dans la colonne `conversionId`. Search Ads 360 requiert que cet ID soit unique pour un champ d'application donné.
`0x0000011E`	`The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)`	L'ID ou le nom de l'activité Floodlight que vous avez indiqués ne correspondent pas au type de conversion que vous avez spécifié.

Signaler les codes de réponse et les messages d'erreur

Si vous demandez un rapport et que la réponse est un message d'erreur, consultez les sections Codes de réponse dans l'API Search Ads 360 et Réponses d'erreur standards pour en savoir plus sur l'erreur.

Les données de l'interface utilisateur de Search Ads 360 ne correspondent pas à un rapport renvoyé par l'API

Par défaut, les données de l'interface utilisateur de Search Ads 360 doivent correspondre aux données renvoyées par l'API. Si vous définissez includeRemovedEntities sur true dans une requête de rapport, assurez-vous que la case Afficher les éléments supprimés est également cochée dans l'UI.