Autorización y encabezados HTTP

bookmark_border Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Necesitas las credenciales de la 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 establecer estos valores y documentos varios encabezados HTTP adicionales específicos de la API que se envían y reciben cuando con la interfaz de REST.

Credenciales de OAuth 2.0

La API de Search Ads 360 Reporting usa credenciales de aplicación para identificar y autorizar a la API solicitudes. Se pueden configurar clientes de OAuth 2.0. Todas las llamadas a la API de Search Ads 360 Reporting se deben autorizar a través de OAuth2. OAuth2 permite que tu aplicación cliente de la API de Search Ads 360 Reporting acceda a la cuenta de Search Ads 360 de un usuario sin tener que administrar 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 las credenciales de tu aplicación y la API de Search Ads 360 Reporting antes de escribir el código de tu . También puedes generar un token de actualización de OAuth ejecutando la secuencia de comandos de generación de credenciales de usuario proporcionada.

Genera 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 usar en llamadas a la API con el 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, usa el token de acceso que mostró la solicitud curl en la 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

Para las llamadas a la API de Search Ads 360 Reporting que realice un administrador a una cuenta de cliente (es decir, accede como administrador para realizar llamadas a la API de una de sus cuentas 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

El request-id es una cadena que identifica de forma exclusiva la solicitud a la API. Cuándo depurar o solucionar problemas con llamadas a la API específicas, el request-id es un identificador importante que debes tener a mano cuando te comunicas con los desarrolladores de Google y asistencia.

request-id: 2a5Cj89VV7CNhya1DZjjrC