Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Autorización y encabezados HTTP

Video: Autenticación

Necesitas tener las credenciales de la aplicación de OAuth 2.0 y un token de desarrollador cuando llames a la API de Google Ads. Si realizas llamadas a la API como una cuenta de administrador de Google Ads, también debes especificar un encabezado login-customer-id con cada solicitud. En esta página, se describe cómo establecer estos valores y documentos con varios encabezados HTTP específicos de la API que se envían y reciben cuando se usa la interfaz REST.

Credenciales de OAuth 2.0

La API de Google Ads utiliza credenciales de aplicaciones para identificar y autorizar solicitudes a la API. Se pueden configurar tanto clientes de OAuth 2.0 como cuentas de servicio. Para obtener más información sobre la configuración de la autorización del cliente, consulta OAuth2 en la API de Google Ads.

Si no estás familiarizado con las API de Google, puedes usar oauth2l o Playground de OAuth 2.0 para experimentar con las credenciales de la aplicación y la API de Google Ads antes de escribir el código de tu app.

Usa flujos de apps web o para computadoras de escritorio

Sigue los pasos a fin de configurar un proyecto en la Consola de API de Google para la API de Google Ads. Registra el ID de cliente y el secreto de cliente y, luego, regresa a esta página.

Una vez que hayas creado un cliente de OAuth, sigue las instrucciones del flujo de app de escritorio o las instrucciones del flujo de app web para generar un token de actualización y un token de acceso.

Usa cuentas de servicio

Sigue las instrucciones comunes en la guía Cuentas de servicio para configurar el acceso a la cuenta de servicio para la API de Google Ads.

Una vez que hayas configurado una cuenta de servicio para acceder a tu cuenta de Google Ads, sigue la guía Cómo usar OAuth 2.0 para aplicaciones de servidor a servidor, y asegúrate de seleccionar la pestaña HTTP/REST. La scope que se debe usar para el acceso a la API de Google Ads es https://www.googleapis.com/auth/adwords.

Genera tokens de acceso nuevos

Una vez que tengas un ID de cliente, un secreto de cliente y un token de actualización, podrás generar un nuevo token de acceso para usarlo en llamadas a la API con la herramienta de línea de comandos de curl:

curl \
  --data "grant_type=refresh_token" \
  --data "client_id=CLIENT_ID" \
  --data "client_secret=CLIENT_SECRET" \
  --data "refresh_token=REFRESH_TOKEN" \
  https://www.googleapis.com/oauth2/v3/token

Luego, usará el token de acceso que muestra la solicitud curl en el encabezado HTTP Authorization de cada llamada a la API a la API de Google Ads:

GET /v11/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

Encabezados de la solicitud

Token de programador

La API de Google Ads también requiere un token de desarrollador para realizar llamadas a la API. Puedes solicitar un token para tu cuenta de administrador directamente desde la IU de Google Ads. Para obtener más detalles sobre la configuración con un token de desarrollador, consulta Cómo obtener tu token de desarrollador.

Debes incluir el valor del token de desarrollador en el encabezado HTTP developer-token de cada llamada a la API a la API de Google Ads:

GET /v11/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

ID de cliente de acceso

En el caso de las llamadas a la API de Google Ads que realiza un administrador a una cuenta de cliente (es decir, cuando accedes como administrador para realizar llamadas a la API a una de sus cuentas de cliente), también debes proporcionar el encabezado HTTP login-customer-id. Este valor representa el ID de cliente de Google Ads del administrador que realiza la llamada a la API.

Incluir este encabezado equivale a elegir una cuenta en la IU de Google Ads después de acceder a su cuenta o hacer clic en su imagen de perfil en la esquina superior derecha de la página. Cuando especifiques el ID de cliente, asegúrate de quitar cualquier guion (—); por ejemplo: 1234567890, no 123-456-7890.

GET /v11/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID

ID de cliente vinculado

Solo los proveedores de estadísticas de aplicaciones de terceros utilizan este encabezado cuando suben conversiones a una cuenta de Google Ads vinculada. Consulta la guía Estructura de llamadas de la API para obtener más detalles.

...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID

Encabezados de respuesta

Los siguientes encabezados se muestran en respuestas HTTP de la API.

ID de solicitud

request-id es una string que identifica de forma única la solicitud a la API. Cuando depuras o solucionas problemas relacionados con llamadas a la API específicas, el request-id es un identificador importante que debes tener a mano para comunicarte con la asistencia para desarrolladores de Google.

request-id: 2a5Cj89VV7CNhya1DZjjrC