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

Cette fonctionnalité permet de gérer les niveaux d'accès aux API par un service Google Cloud organisation, 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écurité de jetons de développement ou la fuite. Vous pouvez ignorer l'envoi de votre jeton de développeur vos appels d'API, mais vous devez quand même envoyer un jeton d'accès.

  • Gérez des projets de console Google API distincts pour les différentes applications: Tout projet associé à l'organisation Google Cloud hérite de l'API niveau d'accès de l'organisation. Cela vous permet de créer plusieurs aux projets de la console Google APIs de cette organisation à des fins une gestion de projet précise, des projets distincts pour les différentes applications, et plusieurs projets de la console Google APIs pour les membres de votre équipe.

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

Prérequis

  • Un jeton de développeur approuvé

    Vous devez disposer d'un jeton de développeur approuvé pour utiliser cette option. Toi vous pouvez trouver un jeton de développeur existant sur la page Centre API de votre compte administrateur Google Ads. Connectez-vous, puis accédez à OUTILS ET PARAMÈTRES > CONFIGURATION > API Center.

  • Une organisation Google Cloud

    L'API Google Ads associe votre jeton de développeur à une organisation Google Cloud. et s'en sert pour déterminer votre accès à l'API niveaux. Il existe plusieurs façons créer une organisation Google Cloud.

    Scénario Étapes
    Vous êtes déjà un Google Workspace ou Google Cloud Client Identity Vous possédez probablement déjà une ressource Organisation. Vous pouvez Chèque et créez si nécessaire.
    Vous n'utilisez pas Google Workspace. ou Google Cloud Identity Inscrivez-vous à l'édition sans frais de Google Cloud Identity. Puis créer votre ressource Organisation.
    Aucune des options précédentes ne vous convient Expliquez votre scénario lorsque vous signez pour le pilote et demander à Google de créer une ressource Organisation pour vous. Cette ressource d'organisation sera détenue et gérée par Google charge.

  • Préparer vos projets dans 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 dans le étape précédente Vérifiez que tous les projets de la console Google APIs pour lesquels vous avez activé L'API Google Ads appartient à cette organisation. Si ce n'est pas le cas, migrez sous l'organisation.

    Si vous possédez déjà un compte Google Workspace ou Google Cloud Google Cloud, il y a de fortes chances que les projets de la console Google APIs qui se trouvent déjà sous votre organisation. Vous pouvez donc ignorer cette étape.
    Vous ne possédez pas d'organisation Google Cloud et vous ne pouvez pas en créer une dans l'étape précédente Assurez-vous d'être tous les deux administrateur de votre gestionnaire API Google Ads. et à votre projet dans la console Google APIs. Vous avez besoin de cette autorisation pour d'effectuer des étapes supplémentaires une fois votre candidature pilote approuvée.

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

    Assurez-vous que votre adresse e-mail de contact pour l'API Google Ads est à jour. Votre contact pour les API consultez la page "Centre API" de votre compte administrateur API Google Ads. Connectez-vous, puis accédez à OUTILS et PARAMÈTRES > CONFIGURATION > API Center.

S'inscrire au programme pilote

Inscrivez-vous au programme pilote. L'équipe Google chargée de la conformité Examinez votre demande et envoyez un e-mail à l'adresse e-mail de contact de l'API avec le l'état d'approbation et des informations supplémentaires.

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

  1. Google va créer pour vous une ressource d'organisation Cloud appartenant à Google. Tout les administrateurs de votre compte administrateur API Google Ads se voient attribuer le rôle suivant : Rôle roles/resourcemanager.projectCreator sur le rôle organisation.

  2. Google enverra un e-mail à votre adresse e-mail de contact pour l'API avec les détails du ressource d'organisation récemment créée.

  3. Connectez-vous à votre compte dans la console Google APIs et suivez les instructions pour déplacer votre projet de la console Google APIs sous la nouvelle organisation.

  4. Répondez à cet e-mail pour indiquer à Google que vos projets ont été transférés dans le nouvelle organisation.

  5. L'équipe Google chargée de la conformité examinera votre demande et enverra un e-mail à votre API votre adresse e-mail de contact avec l'état d'approbation et des informations supplémentaires.

Modifier vos requêtes API

Vous pouvez modifier votre application pour arrêter d'envoyer l'en-tête developer-token lorsque les appels d'API. Il s'agit d'une étape facultative, mais recommandée. Si vous êtes dans le programme pilote, le serveur de l'API Google Ads ignore les developer-token s'ils sont envoyés en même temps des requêtes API.

Java

Bientôt disponible !

.NET

Téléchargez et installez la version 17.1.0 ou ultérieure de l'API Google Ads .NET. bibliothèque.

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/v17/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

Ce changement signifie-t-il que je dois être un client Google Workspace ou Google Cloud pour pouvoir utiliser l'API Google Ads ?

Non. Vous avez besoin d'une organisation Google Cloud pouvant être obtenue dans de nombreux différentes manières. Cette exigence ressemble à la façon dont vous avez besoin de la console Google APIs pour utiliser l'API Google Ads dès aujourd'hui.

Je dois modifier mes niveaux d'accès aux API. Comment faire ?

Pour le moment, vous devez continuer à utiliser le centre API pour demander d'éventuelles modifications Niveaux d'accès aux API.

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

Non. L'API Google Ads commencera automatiquement à utiliser les d'accès aux API au niveau de l'organisation une fois qu'elles sont approuvées.

Quel est le degré d'effort requis pour participer à ce pilote ?

Attendez-vous à des modifications minimales du code. La plupart des développeurs devraient pouvoir pour modifier son application en moins de 30 minutes.

Serai-je facturé si je participe à ce programme pilote ?

En règle générale, non, aucuns frais ne vous seront facturés si vous participez à ce pilote. L'API Google Ads est proposée sans frais, et Google ne modifie pas l'API Google Ads modèle de tarification.

Les scénarios possibles pour obtenir une organisation Google Cloud sont les suivants : ce qui suit:

  1. Vous êtes déjà client Google Workspace ou Google Cloud Identity:

    Les frais liés à l'utilisation normale de ces produits vous seront facturés comme d'habitude. Toi ne sera pas facturé pour la création d'une organisation Google Cloud participant à ce pilote.

  2. Vous avez créé un compte Google Cloud Identity Free Edition :

    Aucuns frais ne vous seront facturés lors de votre inscription à Google Cloud Identity Free Edition ou pour créer une organisation Google Cloud participant à ce pilote.

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

    Comme il s'agit d'une ressource d'organisation cloud interne gérée par Google, ne vous sera donc pas facturé.

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

Vous ne pourrez pas participer à ce cas d'utilisation, car il n'est pas pris en charge pilote.

Cela aura-t-il une incidence sur les autorisations API existantes pour les comptes que je gère à l'aide de l'API Google Ads ?

Non, ce changement n'a aucune incidence sur les autorisations existantes de l'API pour le compte Google Ads comptes que vous gérez à l'aide de l'API Google Ads.

J'ai participé à ce pilote et j'ai un problème ou des commentaires. Comment contacter l'assistance ?

Contactez l'équipe de l'API Google Ads via l'assistance technique de l'API. et expliquez la nature de votre problème. Inclure des détails tels que l'ID de votre organisation, et les journaux de requêtes et de réponses possible.