Flujo de trabajo de la cuenta de servicio

En esta guía, se explica cómo acceder a la API de Google Ads con cuentas de servicio.

Una cuenta de servicio es una cuenta que pertenece a tu app, no a un usuario final individual. Las cuentas de servicio emplean un flujo de OAuth 2.0 que no requiere autorización humana, sino que utiliza un archivo de claves al que solo puede acceder tu app.

El uso de cuentas de servicio proporciona dos beneficios clave:

• La autorización para el acceso a la API de Google Ads a las cuentas de Google Ads se realiza como un paso de configuración, aprovechando las funciones de autorización y administración de cuentas que ofrece la IU de Google Ads. Esto ahorra el esfuerzo de los desarrolladores, ya que no tienen que compilar flujos de OAuth 2.0 ni lidiar con complicaciones que involucran la interacción del usuario, el almacenamiento de credenciales del usuario y la administración de tokens.

• La autorización para acceder a las cuentas de Google Ads no está vinculada a las credenciales de usuarios individuales, lo que puede ser útil en los casos en que se espera que dicha autorización continúe incluso si el empleado que autorizó originalmente el acceso abandona el equipo o la empresa.

Configuración del acceso a la cuenta

1. Comienza por crear una cuenta de servicio y credenciales.

   Descarga la clave de la cuenta de servicio en formato JSON y anota el ID y el correo electrónico de la cuenta de servicio.

2. Accede a tu cuenta de Google Ads como administrador. Navega a Administrador > Acceso y seguridad.

3. Haz clic en el botón + en la pestaña Usuarios.

4. Escribe el correo electrónico de la cuenta de servicio en la casilla de entrada Correo electrónico. Selecciona el nivel de acceso a la cuenta adecuado (ten en cuenta que las cuentas de servicio no admiten el nivel de acceso Solo correo electrónico) y haz clic en el botón Agregar cuenta.

5. Se otorga acceso a la cuenta de servicio.

6. Opcional: De forma predeterminada, no puedes otorgar acceso de administrador a una cuenta de servicio. Sigue el principio de privilegio mínimo y otorga acceso de administrador solo si tus llamadas a la API lo requieren. Puedes actualizar el acceso de la siguiente manera:

   • Haz clic en la flecha del menú desplegable junto al nivel de acceso de la cuenta de servicio en la columna Nivel de acceso.
   • Selecciona Administrador en la lista desplegable.

Configuración de la biblioteca cliente

Selecciona la pestaña correspondiente a tu lenguaje de programación para obtener instrucciones sobre cómo configurar tu biblioteca cliente. Si tu cuenta de servicio accede a cuentas de cliente a través de una cuenta de administrador de Google Ads (MCC), también debes establecer login-customer-id (o loginCustomerId) en el ID de cliente de 10 dígitos de esa cuenta de administrador sin guiones (consulta ID de cliente de acceso).

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "JSON_KEY_FILE_PATH",
    // ...
};
GoogleAdsClient client = new GoogleAdsClient(config);

json_key_file_path: JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

[OAUTH2]
; For service account flow.
jsonKeyFilePath = "JSON_KEY_FILE_PATH"
scopes = "https://www.googleapis.com/auth/adwords"

c.keyfile = 'JSON_KEY_FILE_PATH'

jsonKeyFilePath=JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

gcloud auth login --cred-file=JSON_KEY_FILE_PATH

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

curl -i -X POST \
  https://googleads.googleapis.com/v25/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}