Ten en cuenta que los métodos get y getByCustomerId de la API de conversiones de Search Ads 360 dejarán de estar disponibles en el tercer trimestre de 2025. Para seguir accediendo a los datos de conversiones, debes crear un informe con el recurso de conversión mediante la nueva API de Search Ads 360 Reporting. Obtén más detalles aquí.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Search Ads 360 requiere que todas las solicitudes especifiquen un token de acceso de OAuth 2.0 para la autenticación. Puedes seguir cualquier flujo de trabajo de autenticación estándar de OAuth 2.0 para generar el token y pasarlo a la API de Search Ads 360. Recomendamos el flujo de trabajo que se describe a continuación, ya que es adecuado para las cargas de conversiones y las descargas de informes completamente automatizadas.
Si deseas conocer alternativas al flujo de trabajo que se describe a continuación, consulta Usa OAuth 2.0 para aplicaciones instaladas o
Usa OAuth 2.0 para aplicaciones de servidor a servidor. Si usas un flujo de trabajo alternativo, especifica el siguiente valor como el parámetro scope cuando solicites un código de autorización de OAuth 2.0: https://www.googleapis.com/auth/doubleclicksearch Si sigues la ruta de servidor a servidor, agrega la cuenta de servicio como usuario de Search Ads 360.
Esta es la Cuenta de Google que tu cliente de la API usará para autenticarse con Search Ads 360.
Si el titular de la Cuenta de Google abandona tu empresa y quitas el acceso a Search Ads 360 de la cuenta, deberás repetir este flujo de trabajo de autorización y especificar otra Cuenta de Google.
La secuencia de comandos te guía por el proceso de usar el ID y el secreto de cliente de OAuth para obtener un token de actualización. El token de actualización solo es válido para la Cuenta de Google a la que accediste en el paso anterior.
Como parte de este proceso, la secuencia de comandos genera una URL y te indica que la visites en un navegador web.
Cuando el navegador te solicite que permitas que el cliente de OAuth acceda a los datos de Search Ads 360, asegúrate de que aparezca la Cuenta de Google a la que accediste antes. (si accediste a varias Cuentas de Google, es posible que veas una cuenta diferente).
Al final del proceso, la secuencia de comandos sa360Api.py genera una cadena delimitada por comas. El primer valor es el ID de cliente que proporcionaste, el segundo es el secreto del cliente que proporcionaste y el tercer valor es el token de actualización. En el siguiente resultado de ejemplo, el token de actualización está en texto en negrita: 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
Almacena el ID de cliente, el secreto de cliente y el token de actualización en una base de datos de backend o en otra ubicación segura a la que pueda acceder tu aplicación.
Mantén toda la string delimitada por comas en una ubicación conveniente si planeas usar sa360Api.py para enviar solicitudes JSON de muestra a la API de Search Ads 360. Pasarás la cadena completa como parámetro cada vez que invoques la secuencia de comandos.
Agrega a tu aplicación código que realice las siguientes acciones:
Utiliza el ID de cliente, el secreto de cliente y el token de actualización para obtener un nuevo token de acceso de OAuth 2.0.
Envía solicitudes a la API de Search Ads 360 con el token de acceso nuevo.
Si usas las bibliotecas cliente, en la siguiente sección, Configura tu aplicación, se describe cómo agregar este código de autorización a tu aplicación.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
