Configurer l'autorisation
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Search Ads 360 exige que toutes les requêtes spécifient un jeton d'accès OAuth 2.0 pour l'authentification. Vous pouvez suivre n'importe quel workflow d'authentification OAuth 2.0 standard pour générer le jeton et le transmettre à l'API Search Ads 360. Nous vous recommandons le workflow décrit ci-dessous, car il convient aux importations de conversions et aux téléchargements de rapports entièrement automatisés.
Pour découvrir des alternatives au workflow décrit ci-dessous, consultez les pages Utiliser OAuth 2.0 pour les applications installées ou
Utiliser OAuth 2.0 pour les applications de serveur à serveur. Si vous utilisez un autre workflow, spécifiez la valeur suivante comme paramètre scope lorsque vous demandez un code d'autorisation OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
Si vous suivez la méthode de serveur à serveur, ajoutez le compte de service en tant qu'utilisateur de Search Ads 360.
Workflow d'autorisation recommandé
- Accédez à la console Google APIs, puis sélectionnez votre projet.
Si vous n'avez pas encore créé de projet Google APIs Console et d'identifiants OAuth, suivez les instructions de la section Créer un projet Google APIs Console et des identifiants OAuth pour votre client.
Pour trouver l'ID client et le secret OAuth de votre projet, procédez comme suit:
- Ouvrez la page Identifiants.
- Dans la colonne Nom, cliquez sur le nom de votre client OAuth.
- L'ID client et le code secret sont répertoriés sur cette page.
- Ouvrez un navigateur Web et connectez-vous à Google
avec un compte Google disposant de l'autorisation d'accéder aux données dans Search Ads 360.
Il s'agit du compte Google que votre client d'API utilisera pour s'authentifier auprès de Search Ads 360.
Si le titulaire du compte Google quitte votre entreprise et que vous supprimez l'accès à Search Ads 360 du compte, vous devrez répéter ce workflow d'autorisation et spécifier un autre compte Google.
- Obtenez un jeton d'actualisation en appelant le script de l'utilitaire Search Ads 360 comme suit:
sa360Api.py --login
Le script vous explique comment utiliser l'ID client et le secret OAuth pour obtenir un jeton d'actualisation. Le jeton d'actualisation n'est valide que pour le compte Google auquel vous vous êtes connecté à l'étape précédente.
Dans le cadre de ce processus, le script génère une URL et vous invite à y accéder dans un navigateur Web.
-
Lorsque le navigateur vous demande d'autoriser l'accès du client OAuth aux données Search Ads 360, assurez-vous que le compte Google auquel vous vous êtes connecté précédemment s'affiche. (Si vous êtes connecté à plusieurs comptes Google, un compte différent peut s'afficher.)
À la fin du processus, le script sa360Api.py génère une chaîne de valeurs séparées par des virgules. La première valeur est l'ID client que vous avez fourni, la deuxième valeur est le code secret du client que vous avez fourni et la troisième valeur est le jeton d'actualisation. Dans l'exemple de résultat suivant, le jeton d'actualisation est en gras:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
- Stockez l'ID client, le code secret du client et le jeton d'actualisation dans une base de données backend ou dans un autre emplacement sécurisé accessible par votre application.
Conservez l'intégralité de la chaîne délimitée par virgule dans un emplacement pratique si vous prévoyez d'utiliser sa360Api.py pour envoyer des exemples de requêtes JSON à l'API Search Ads 360. Vous transmettrez l'intégralité de la chaîne en tant que paramètre chaque fois que vous appelez le script.
- Ajoutez du code à votre application qui effectue les opérations suivantes :
- Utilisez l'ID client, le secret client et le jeton d'actualisation pour obtenir un nouveau jeton d'accès OAuth 2.0.
- Envoyez des requêtes à l'API Search Ads 360 à l'aide du nouveau jeton d'accès.
Si vous utilisez les bibliothèques clientes, la section suivante, Configurer votre application, explique comment ajouter ce code d'autorisation à votre application.
Si vous n'utilisez pas l'une des bibliothèques clientes, consultez Utiliser OAuth 2.0 pour les applications installées pour obtenir des suggestions sur l'obtention d'un nouveau jeton d'accès.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/11/07 (UTC).
[null,null,["Dernière mise à jour le 2024/11/07 (UTC)."],[[["\u003cp\u003eThe Search Ads 360 API requires OAuth 2.0 access tokens for authentication, obtainable through standard OAuth 2.0 workflows or the recommended workflow outlined in the document.\u003c/p\u003e\n"],["\u003cp\u003eThe recommended workflow involves obtaining a refresh token using the provided utility script and storing it securely along with the client ID and secret.\u003c/p\u003e\n"],["\u003cp\u003eApplications should be designed to use the stored credentials to obtain fresh access tokens for API requests, as detailed in the "Set Up Your Application" section or relevant OAuth 2.0 documentation.\u003c/p\u003e\n"],["\u003cp\u003eAlternative workflows for installed or server-to-server applications are available with specific scope requirements and user management considerations.\u003c/p\u003e\n"]]],["The Search Ads 360 API requires OAuth 2.0 access tokens for authentication. The recommended workflow involves creating a Google API Console project and obtaining OAuth credentials. Users sign into a Google Account with Search Ads 360 access, then use the `sa360Api.py` script to generate a refresh token. The script outputs client ID, client secret, and refresh token. Store these securely, and use them in your application to obtain a fresh OAuth access token for API requests.\n"],null,["# Set Up Authorization\n\nThe Search Ads 360 API requires all requests to specify an [OAuth 2.0](/accounts/docs/OAuth2)\naccess token for authentication. You can follow any standard OAuth 2.0 authentication workflow\nto generate the token and pass it to the Search Ads 360 API. We recommend the workflow described\nbelow because it is suitable for fully automated conversion uploads and report downloads.\n\n\nFor alternatives to the workflow described below, see [Using\nOAuth 2.0 for Installed Applications](https://developers.google.com/accounts/docs/OAuth2InstalledApp) or\n[Using OAuth 2.0 for Server to Server Applications](https://developers.google.com/identity/protocols/OAuth2ServiceAccount). If you use an alternate workflow,\nspecify the following value as the `scope` parameter when you request an OAuth\n2.0 authorization code: \n\n`https://www.googleapis.com/auth/doubleclicksearch`\n\nIf you follow the server to server route, add the service account as a Search Ads 360 user.\n\nRecommended authorization workflow\n----------------------------------\n\n1. Go to the [Google API Console](https://console.cloud.google.com/) and select your project.\n\n\n If you haven't already created a Google API Console project and OAuth credentials, follow\n the instructions in [Create a Google API\n Console project and OAuth credentials for your client](/search-ads/v2/prereqs#project).\n\n To find your project's OAuth client ID and secret, do the following:\n 1. Open the [Credentials page](https://console.cloud.google.com/apis/credentials).\n 2. In the **Name** column, click the name of your OAuth client.\n 3. The client ID and secret are listed on the page.\n2. Open a web browser and [sign into Google](https://accounts.google.com/ServiceLogin)with a Google Account that [has\n permission to access data](/search-ads/v2/prereqs#permissions) in Search Ads 360.\n\n This is the Google Account your API client will use to authenticate with Search Ads 360.\n If the Google Account holder leaves your company and you remove Search Ads 360 access\n from the account, you will need to repeat this authorization workflow and specify a\n different Google Account.\n3. Obtain a refresh token by invoking the [Search Ads 360 utility script](/search-ads/v2/prereqs#ds3py) as follows:\n\n\n `sa360Api.py --login`\n\n\n The script takes you through the process of using the Oauth client ID and secret to\n obtain a refresh token. The refresh token is valid only for the Google Account you signed\n into during the previous step.\n\n As part of this process, the script generates a URL and instructs you to\n visit the URL in a web browser.\n4. When the browser asks you to allow OAuth client access to Search Ads 360 data,\n make sure the Google Account you signed into earlier appears. (If you're signed into multiple\n Google Accounts, you might be presented with a different account.)\n\n\n At the end of the process, the `sa360Api.py` script outputs a comma-delimited\n string. The first value is the client ID you provided, the second value is the client\n secret you provided, and the third value is the refresh token. In the following example\n output, the refresh token is in **bold text** : \n\n `123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,`**1/HIJklM01OPQR23NOP456rst890uvw**\n5. Store the client ID, client secret, and refresh token in a backend database or other secure location that's accessible to your application.\n Keep the entire comma-delimited string in a convenient location if you plan to use\n `sa360Api.py` to send sample JSON requests to the Search Ads 360 API. You'll pass the\n entire string as a parameter each time you invoke the script.\n\n6. Add code to your application that does the following:\n 1. Use the client ID, client secret, and refresh token to obtain a fresh OAuth 2.0 access token.\n 2. Send requests to the Search Ads 360 API using the fresh access token.\n\n\n If you're using the client libraries, the next section, [Set Up Your Application](/search-ads/v2/configure),\n describes how to add this authorization code to your application.\n\n\n If you're not using one of the client libraries, see [Using OAuth 2.0 for Installed Applications](https://developers.google.com/accounts/docs/OAuth2InstalledApp) for\n suggestions on obtaining a fresh access token."]]
