Passer de la version 1.1 à la version 2 de l'API Bid Manager

En mars 2022, nous avons publié la version 2 de l'API Bid Manager. Étant donné le de cette nouvelle version, nous prévoyons d'annoncer bientôt la date d'abandon de la v1.1. Mer nous vous recommandons de commencer votre migration de la version 1.1 vers la version 2 dès que possible.

Migrer votre application

La migration de la version 1.1 vers la version 2 nécessite la mise à jour de vos URL de point de terminaison pour appeler la version 2. et de mettre à jour votre application pour tenir compte des modifications destructives.

Mettre à jour vos appels d'API de la version 1.1 à la version 2

Pour utiliser la version 2 au lieu de la version 1.1, vous devez mettre à jour vos requêtes afin qu'elles utilisent la nouvelle version v2 les points de terminaison.

Identifier les méthodes équivalentes

Pour faire passer vos appels d'API de la version 1.1 à la version 2, vous devez d'abord identifier les méthodes équivalentes de la version 1.1 dans la version 2.

Les noms suivants de tous les services et méthodes ont légèrement changé entre v1.1 et v2:

Mise à jour vers les nouveaux points de terminaison

Une fois que vous avez identifié des méthodes équivalentes, vous devez mettre à jour vos requêtes. Pour Par exemple, pour appeler la méthode queries.getquery avec la version 1.1, vous devez utiliser l'URL suivante:

https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId

Pour appeler la méthode équivalente (appelée queries.get) dans la version 2, modifiez la URL de la page suivante:

GET https://doubleclickbidmanager.googleapis.com/v2/queries/queryId

Si vous utilisez une bibliothèque cliente pour envoyer des requêtes à l'API, utilisez la méthode version récente de la bibliothèque cliente et mettez à jour votre configuration pour qu'elle utilise la version 2.

Apporter les modifications requises

Nous apportons un certain nombre de modifications importantes dans la v2. Passez en revue les éléments suivants instructions et d'apporter les modifications nécessaires à votre utilisation actuelle du API Bid Manager.

Mettre à jour les appels au service queries

Mettre à jour les appels au service reports

Mettre à jour la logique de gestion des erreurs

Les messages d'erreur de l'API ont été mis à jour dans la version 2. Ces nouveaux messages d'erreur sont plus spécifiques et, dans certains cas, fournissent des informations sur les valeurs de l'attribut Requête API à l'origine de l'erreur. Si l'erreur s'appuie sur un texte de message d'erreur spécifique, généralisez votre erreur avant de migrer vers la v2.