Erreurs asynchrones

Étant donné que ExperimentService inclut plusieurs opérations asynchrones, le mécanisme de récupération des erreurs liées à ces opérations diffère des opérations synchrones.

Opérations concernées

Les opérations asynchrones qui utilisent ce mécanisme de signalement d'erreurs sont les suivantes :

Comment les opérations de longue durée gèrent-elles les erreurs ?

Pour ces méthodes, l'API renvoie une opération de longue durée (google.longrunning.Operation) que vous pouvez interroger pour vérifier l'état de l'exécution asynchrone. Une fois l'opération terminée (done = true), google.longrunning.Operation renseigne soit response (avec google.protobuf.Empty en cas de réussite), soit error (avec un résumé google.rpc.Status si des erreurs asynchrones se sont produites).

Si la liste complète des erreurs était renvoyée directement dans la charge utile de l'opération de longue durée, des erreurs pourraient être ignorées si l'interrogation s'arrête prématurément, et la charge utile de la réponse pourrait devenir excessivement volumineuse pour une requête d'interrogation. À la place, le champ error de l'opération de longue durée indique que des erreurs se sont produites, et vous récupérez les erreurs Status détaillées à partir d'un point de terminaison de pagination dédié.

Récupérer les erreurs asynchrones

Pour récupérer la liste complète des erreurs d'une opération de longue durée d'un test, appelez ExperimentService.ListExperimentAsyncErrors. Transmettez le nom de ressource du test (resource_name) et un page_size facultatif, puis parcourez les entrées Status renvoyées à l'aide de page_token, comme vous le feriez pour toute autre requête de liste de l'API Google Ads :

GET https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/experiments/EXPERIMENT_ID:listExperimentAsyncErrors?pageSize=100