Cette fonctionnalité vous permet de gérer vos niveaux d'accès aux API à l'aide d'une organisation Google Cloud, ce qui vous offre les avantages suivants :
Plus besoin de sécuriser les jetons de développeur : l'accès aux API est géré via l'organisation Google Cloud. Vous n'avez donc plus à vous soucier de la sécurisation ou de la fuite des jetons de développeur. Vous pouvez ne pas envoyer votre jeton de développeur dans vos appels d'API, mais vous devez toujours envoyer un jeton d'accès.
Conservez des projets Google API Console distincts pour différentes applications : tout projet associé à l'organisation Google Cloud hérite du niveau d'accès à l'API de l'organisation. Cela vous permet de créer plusieurs projets dans la console Google APIs sous cette organisation à des fins telles que la gestion précise des projets, des projets distincts pour différentes applications et plusieurs projets dans la console Google APIs pour les membres de votre équipe.
Surveillance et gestion plus précises des quotas : vous pouvez surveiller l'utilisation des API pour chaque projet ou limiter l'utilisation des API.
Prérequis
Un jeton de développeur approuvé
Vous devriez déjà disposer d'un jeton de développeur approuvé pour utiliser cette option. Vous pouvez trouver un jeton de développeur existant dans le Centre API de votre compte administrateur Google Ads. Connectez-vous, puis accédez à Admin > Centre d'informations sur les API. Dans le centre d'API, accédez à Accès à l'API > Jeton de développeur.
Une organisation Google Cloud
L'API Google Ads associe votre jeton de développeur à une organisation Google Cloud et l'utilise pour déterminer vos niveaux d'accès à l'API. Il existe plusieurs façons de créer une organisation Google Cloud.
Scénario Étapes Vous êtes déjà client Google Workspace ou Google Cloud Identity. Il y a de fortes chances que vous possédiez déjà une ressource d'organisation. Vous pouvez vérifier et créer un compte si nécessaire. Vous n'utilisez pas Google Workspace ni Google Cloud Identity. Inscrivez-vous à l'édition sans frais de Google Cloud Identity. Ensuite, créez votre ressource d'organisation. Aucune des options précédentes ne fonctionne pour vous Expliquez votre scénario lorsque vous vous inscrivez au pilote et demandez à Google de créer une ressource d'organisation pour vous. Google possédera et gérera cette ressource d'organisation sans frais. Préparer vos projets de la console Google APIs pour le programme pilote
Vous devez préparer les projets de la console Google APIs que vous utilisez avec l'API Google Ads pour le programme pilote comme suit :
Scénario Étapes Vous possédez déjà une organisation Google Cloud ou vous en avez créé une à l'étape précédente. Assurez-vous que tous les projets de la console Google APIs dans lesquels vous avez activé l'API Google Ads appartiennent à cette organisation. Si ce n'est pas le cas, migrez-le vers l'organisation. Si vous êtes déjà client Google Workspace ou Google Cloud Identity, il est probable que les projets de la console Google APIs soient déjà associés à votre organisation. Vous pouvez donc ignorer cette étape.
Vous ne possédez pas d'organisation Google Cloud et vous n'avez pas pu en créer une à l'étape précédente. Assurez-vous d'être un utilisateur administrateur de votre compte administrateur de l'API Google Ads et de votre projet de la console Google APIs. Vous en aurez besoin pour effectuer des étapes supplémentaires une fois votre demande de pilote approuvée. Une adresse e-mail de contact pour l'API à jour
Assurez-vous que l'adresse e-mail de contact de l'API Google Ads est à jour. Les coordonnées de votre contact pour l'API sont indiquées sur la page "Centre d'API" de votre compte administrateur de l'API Google Ads. Connectez-vous, puis accédez à OUTILS ET PARAMÈTRES > CONFIGURATION > Centre d'API.
S'inscrire au programme pilote
Inscrivez-vous au programme pilote. L'équipe Google chargée de la conformité examinera votre demande et enverra un e-mail à l'adresse de contact de l'API pour vous informer de l'état de l'approbation et vous fournir des informations supplémentaires.
Si vous avez demandé à Google de créer une organisation Google Cloud pour vous, vous devez suivre quelques étapes supplémentaires :
Google créera une ressource d'organisation Cloud appartenant à Google pour vous. Tous les administrateurs de votre compte Google Ads API Manager se verront attribuer le rôle
roles/resourcemanager.projectCreatordans la nouvelle organisation.Google enverra un e-mail à l'adresse de contact de votre API avec les détails de la ressource d'organisation nouvellement créée.
Vous devez vous connecter à votre compte de la console Google APIs et suivre les instructions pour déplacer votre projet de la console Google APIs vers la nouvelle organisation.
Répondez à l'e-mail pour informer Google que vos projets ont été déplacés vers la nouvelle organisation.
L'équipe Google chargée de la conformité examinera votre demande et enverra un e-mail à l'adresse de contact de votre API pour vous informer de l'état de l'approbation et vous fournir des informations supplémentaires.
Modifier vos requêtes API
Vous pouvez modifier votre application pour qu'elle cesse d'envoyer l'en-tête developer-token lors des appels d'API. Il s'agit d'une étape facultative, mais recommandée. Si vous participez au programme pilote, le serveur de l'API Google Ads ignore le developer-token s'il est envoyé dans les requêtes API.
Java
Bientôt disponible !
.NET
Téléchargez et installez la version 17.1.0 ou ultérieure de la bibliothèque .NET de l'API Google Ads.
Ensuite, modifiez votre code comme suit :
// Create a client.
GoogleAdsClient client = new GoogleAdsClient();
// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;
// Make the API calls.
...
PHP
Bientôt disponible !
Python
Bientôt disponible !
Ruby
Bientôt disponible !
Perl
Bientôt disponible !
Client HTTP (REST)
Omettez l'en-tête developer-token dans vos requêtes HTTP :
curl -i -X POST https://googleads.googleapis.com/v21/customers/CUSTOMER_ID/googleAds:searchStream \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "login-customer-id: LOGIN_CUSTOMER_ID" \
--data-binary "@query.json"Questions fréquentes
Voici quelques questions fréquentes sur les niveaux d'accès gérés dans le cloud.
Cette modification signifie-t-elle que je dois être client Google Workspace ou Google Cloud pour utiliser l'API Google Ads ?
Non. Vous avez besoin d'une organisation Google Cloud, que vous pouvez obtenir de plusieurs façons. Cette exigence est semblable à celle qui vous oblige à disposer d'un projet dans la console Google APIs pour utiliser l'API Google Ads aujourd'hui.
Je dois modifier mes niveaux d'accès à l'API. Comment faire ?
Pour le moment, vous devez continuer à utiliser le centre d'API pour demander des modifications des niveaux d'accès aux API.
Y a-t-il un temps d'arrêt pour participer à ce pilote ?
Non. Une fois l'accès approuvé, l'API Google Ads commencera automatiquement à utiliser les niveaux d'accès aux API au niveau de l'organisation.
Combien d'efforts sont nécessaires pour participer à ce pilote ?
Attendez-vous à des modifications minimes au niveau du code. La plupart des développeurs devraient pouvoir apporter des modifications à leur application en moins de 30 minutes.
Serai-je facturé si je participe à ce pilote ?
En général, non. Vous ne serez pas facturé si vous participez à ce pilote. L'API Google Ads est proposée sans frais, et Google ne modifie pas son modèle de tarification.
Voici les scénarios possibles pour obtenir une organisation Google Cloud :
Vous êtes déjà client Google Workspace ou Google Cloud Identity :
L'utilisation normale de ces produits vous sera facturée comme d'habitude. La création d'une organisation Google Cloud pour participer à ce pilote ne vous sera pas facturée.
Vous avez créé un compte Google Cloud Identity édition sans frais :
Aucun frais ne vous sera facturé lorsque vous vous inscrirez à un compte Google Cloud Identity Free Edition ou lorsque vous créerez une organisation Google Cloud pour participer à ce pilote.
Google a créé une ressource d'organisation Cloud pour vous :
Il s'agit d'une ressource d'organisation Cloud interne gérée par Google. Vous ne serez donc pas facturé.
J'ai plusieurs jetons de développeur pour différents outils. Quelles sont les conséquences de ce pilote pour moi ?
Ce cas d'utilisation n'est pas pris en charge. Vous ne pourrez donc pas participer à ce pilote.
Cela affecte-t-il les autorisations d'API existantes pour les comptes que je gère à l'aide de l'API Google Ads ?
Non, cette modification n'affecte aucune autorisation d'API existante pour les comptes Google Ads que vous gérez à l'aide de l'API Google Ads.
J'ai activé ce pilote et je rencontre un problème ou j'ai des commentaires à formuler. Comment contacter l'assistance ?
Contactez l'équipe de l'API Google Ads sur la page d'assistance technique de l'API et expliquez la nature de votre problème. Incluez des informations telles que l'ID de votre organisation, ainsi que les journaux des requêtes et des réponses, si possible.