Niveaux d'accès gérés par le cloud

Remarque :Google accepte les candidatures à ce programme. Inscrivez-vous.

Cette fonctionnalité permet de gérer les niveaux d'accès à vos API par 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é par l'organisation Google Cloud. Vous n'avez donc plus besoin de vous soucier de la sécurisation des jetons de développeur ni de leur fuite. Vous pouvez ignorer l'envoi de votre jeton de développeur dans vos appels d'API, mais vous devez toujours envoyer un jeton d'accès.

• Gérez des projets Google API Console distincts pour différentes applications:tout projet associé à l'organisation Google Cloud hérite du niveau d'accès aux API de l'organisation. Vous pouvez ainsi créer plusieurs projets Google APIs Console dans cette organisation à des fins telles que la gestion précise des projets, la création de projets distincts pour différentes applications et la création de plusieurs projets Google APIs Console pour les membres de votre équipe.

• Surveillance et gestion plus précises des quotas: vous pouvez surveiller l'utilisation des API de projets individuels ou limiter l'utilisation des API.

Prérequis

• Un jeton de développeur approuvé

  Vous devez 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 des API. Dans le centre des API, accédez à Accès aux 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 est probable que vous possédiez déjà une ressource d'organisation. Vous pouvez vérifier et en créer un si nécessaire.
  Vous n'utilisez pas Google Workspace ou Google Cloud Identity.	Inscrivez-vous à l'édition sans frais de Google Cloud Identity. Ensuite, créez votre ressource "Organisation".
  Aucune des options précédentes ne vous convient	Expliquez votre scénario lorsque vous vous inscrivez au pilote et demandez à Google de créer une ressource d'organisation pour vous. Google sera propriétaire et gérera cette ressource d'organisation sans frais.

• Préparer vos projets Google API Console 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 sont associés à 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 administrateur à la fois de votre compte administrateur de l'API Google Ads et de votre projet dans la console Google APIs. Vous avez besoin de cette autorisation pour effectuer des étapes supplémentaires une fois votre application pilote approuvée.

• Une adresse e-mail de contact de l'API à jour

  Assurez-vous que l'adresse e-mail de votre contact pour l'API Google Ads est à jour. Vos coordonnées API sont indiquées sur la page du centre des API de votre compte administrateur d'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 du respect des règles examinera ensuite votre demande et vous enverra l'état d'approbation et des informations supplémentaires par e-mail à l'adresse de contact de votre API.

Si vous avez demandé à Google de créer une organisation Google Cloud pour vous, vous devez suivre quelques étapes supplémentaires:

1. Google créera pour vous une ressource d'organisation Cloud appartenant à Google. Tous les administrateurs de votre compte administrateur de l'API Google Ads recevront le rôle roles/resourcemanager.projectCreator dans l'organisation nouvellement créée.

2. Google enverra les informations de la ressource d'organisation nouvellement créée par e-mail à l'adresse e-mail de contact de l'API.

3. Vous devez vous connecter à votre compte Google APIs Console et suivre les instructions pour déplacer votre projet Google APIs Console vers la nouvelle organisation.

4. Répondez à l'e-mail pour indiquer à Google que vos projets sont déplacés vers la nouvelle organisation.

5. L'équipe Google chargée du respect des règles examinera votre demande et vous enverra l'état d'approbation et des informations supplémentaires par e-mail à l'adresse de contact de votre API.

Modifier vos requêtes API

Vous pouvez modifier votre application pour arrêter d'envoyer l'en-tête developer-token lorsque vous effectuez 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 le cadre des requêtes de l'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)

Omettre l'en-tête developer-token dans vos requêtes HTTP:

curl -i -X POST https://googleads.googleapis.com/v18/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

Cette modification signifie-t-elle que je dois être client Google Workspace ou Google Cloud pour utiliser l'API Google Ads ?

Non. Vous devez disposer d'une organisation Google Cloud, que vous pouvez obtenir de nombreuses 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 aux API. Comment faire ?

Pour le moment, vous devez continuer à utiliser le centre des API pour demander toute modification des niveaux d'accès aux API.

Y a-t-il un temps d'arrêt pour activer ce pilote ?

Non. Une fois approuvée, l'API Google Ads commencera automatiquement à utiliser les niveaux d'accès aux API au niveau de l'organisation.

Combien d'efforts faut-il fournir pour participer à ce pilote ?

Attendez-vous à des modifications minimes du code. La plupart des développeurs devraient pouvoir effectuer les modifications de leur application en moins de 30 minutes.

Vais-je être facturé si je participe à ce projet 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:

1. Vous êtes un client Google Workspace ou Google Cloud Identity existant:

   Vous serez facturé comme d'habitude pour toute utilisation régulière de ces produits. La création d'une organisation Google Cloud dans le cadre de ce pilote ne vous sera pas facturée.

2. Vous avez créé un compte Google Cloud Identity édition sans frais:

   Vous ne serez pas facturé lorsque vous vous inscrirez à l'édition sans frais de Google Cloud Identity ou lorsque vous créerez une organisation Google Cloud dans le but de participer à ce pilote.

3. Google a créé une ressource d'organisation Cloud pour vous:

   Il s'agit d'une ressource Cloud interne gérée par Google. Par conséquent, vous ne serez pas facturé.

Je dispose de plusieurs jetons de développeur pour différents outils. En quoi ce pilote me concerne-t-il ?

Ce cas d'utilisation n'étant pas pris en charge, vous ne pourrez 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 j'ai un problème ou des commentaires à formuler. Comment contacter l'assistance ?

Contactez l'équipe de l'API Google Ads à l'aide de 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 de requêtes et de réponses, si possible.