Necesitas credenciales de aplicación de OAuth 2.0 cuando llames a la API de Search Ads 360 Reporting. Si realizas llamadas a la API como una cuenta de administrador de Search Ads 360, también debes especificar un encabezado login-customer-id con cada solicitud. En esta página, se describe cómo configurar estos valores y se documentan varios encabezados HTTP adicionales 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 Search Ads 360 Reporting usa credenciales de la aplicación para identificar y autorizar solicitudes a la API. Se pueden configurar clientes de OAuth 2.0. Todas las llamadas a la API de Search Ads 360 Reporting deben estar autorizadas a través de OAuth2. OAuth2 permite que tu app cliente de la API de informes de Search Ads 360 acceda a la cuenta de Search Ads 360 de un usuario sin tener que controlar ni almacenar su información de acceso.
Si eres nuevo en las APIs de Google, puedes usar oauth2l o OAuth 2.0 Playground para experimentar con las credenciales de la aplicación y la API de informes de Search Ads 360 antes de escribir el código de tu app. También puedes generar un token de actualización de OAuth ejecutando la secuencia de comandos de generación de credenciales de usuario proporcionada.
Generación de tokens de acceso nuevos
Una vez que tengas un ID de cliente, un secreto de cliente y un token de actualización, puedes generar un nuevo token de acceso para usarlo en llamadas a la API con la herramienta de línea de comandos 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, usa el token de acceso que muestra la solicitud de curl en el encabezado HTTP Authorization de cada llamada a la API de Search Ads 360 Reporting:
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
Encabezados de la solicitud
ID de cliente de acceso
En el caso de las llamadas a la API de Search Ads 360 Reporting 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 Search Ads 360 del administrador que realiza la llamada a la API.
Incluir este encabezado equivale a elegir una cuenta en la IU de Search Ads 360 después de acceder o hacer clic en tu imagen de perfil en la esquina superior derecha de la página. Cuando especifiques el ID de cliente, asegúrate de quitar los guiones (—), por ejemplo: 1234567890, no 123-456-7890.
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
Encabezados de respuesta
Los siguientes encabezados se muestran en las respuestas HTTP de la API.
ID de solicitud
request-id es una cadena que identifica de forma exclusiva la solicitud a la API. Cuando se depura o se solucionan problemas con llamadas a la API específicas, request-id es un identificador importante que debes tener a mano cuando te comuniques con el equipo de asistencia para desarrolladores de Google.
request-id: 2a5Cj89VV7CNhya1DZjjrC