Niveles de acceso administrados en la nube

Esta función permite que una organización de Google Cloud administre tus niveles de acceso a la API, lo que te brinda los siguientes beneficios:

  • Ya no es necesario proteger los tokens de desarrollador: El acceso a la API se administra a través de la organización de Google Cloud, por lo que ya no debes preocuparte por proteger los tokens de desarrollador ni por filtrarlos. Puedes omitir el envío de tu token de desarrollador en tus llamadas a la API, aunque debes enviar un token de acceso.

  • Mantén proyectos de la Consola de API de Google separados para diferentes apps: Cualquier proyecto vinculado a la organización de Google Cloud hereda el nivel de acceso a la API de la organización. Esto te permite crear varios proyectos de la Consola de API de Google en esta organización para fines como la administración de proyectos detallados, la separación de proyectos para diferentes apps y varios proyectos de la Consola de API de Google para los miembros de tu equipo.

  • Supervisión y administración de cuotas más detalladas: Puedes supervisar el uso de la API de proyectos individuales o limitar el uso de la API.

Requisitos previos

  • Un token de desarrollador aprobado

    Ya deberías tener un token de desarrollador aprobado para usar esta opción. Puedes encontrar un token de desarrollador existente en el Centro de la API de tu cuenta de administrador de Google Ads. Accede y, luego, navega a Administrador > Centro de la API. En el Centro de la API, navega a Acceso a la API > Token de desarrollador.

  • Una organización de Google Cloud

    La API de Google Ads asocia tu token de desarrollador a una organización de Google Cloud y lo usa para determinar tus niveles de acceso a la API. Existen varias formas de crear una organización de Google Cloud.

    Situación Pasos
    Si ya eres cliente de Google Workspace o Google Cloud Identity Es probable que ya tengas un recurso de organización. Puedes verificar si tienes una y crearla si es necesario.
    No usas Google Workspace ni Google Cloud Identity. Regístrate en la edición gratuita de Google Cloud Identity. Luego, crea el recurso de tu organización.
    Ninguna de las opciones anteriores funciona para ti Explica tu situación cuando te registres en la prueba piloto y solicita a Google que cree un recurso de organización por ti. Google será propietario y administrará este recurso de la organización sin costo.

  • Prepara tus proyectos de la Consola de APIs de Google para el programa piloto

    Debes preparar los proyectos de la Consola de APIs de Google que usas con la API de Google Ads para el programa piloto de la siguiente manera:

    Situación Pasos
    Ya tienes una organización de Google Cloud o creaste una en el paso anterior Asegúrate de que todos los proyectos de la Consola de APIs de Google en los que habilitaste la API de Google Ads estén en esta organización. Si no es así, migrálo a la organización.

    Si ya eres cliente de Google Workspace o Cloud Identity de Google Cloud, es probable que los proyectos de la Consola de la API de Google ya estén en tu organización, por lo que puedes omitir este paso.
    No tienes una organización de Google Cloud y no pudiste crear una en el paso anterior Asegúrate de ser un usuario administrador en tu cuenta de administrador de la API de Google Ads y en tu proyecto de la Consola de APIs de Google. Necesitas este permiso para realizar pasos adicionales después de que se apruebe tu solicitud de prueba piloto.

  • Un correo electrónico de contacto de la API actualizado

    Asegúrate de que el correo electrónico de contacto de la API de Google Ads esté actualizado. Los detalles de contacto de tu API se muestran en la página del Centro de APIs de tu cuenta de administrador de la API de Google Ads. Accede y, luego, navega a HERRAMIENTAS Y CONFIGURACIÓN > CONFIGURACIÓN > Centro de la API.

Regístrate en el programa piloto

Regístrate en el programa piloto. Luego, el equipo de Cumplimiento de Google revisará tu solicitud y te enviará un correo electrónico a la dirección de correo electrónico de contacto de la API con el estado de aprobación y detalles adicionales.

Si solicitaste a Google que cree una organización de Google Cloud por ti, hay algunos pasos adicionales:

  1. Google creará un recurso de organización de Cloud propiedad de Google por ti. A todos los administradores de tu cuenta de administrador de la API de Google Ads se les otorgará el rol roles/resourcemanager.projectCreator en la organización recién creada.

  2. Google enviará un correo electrónico a tu dirección de correo electrónico de contacto de la API con los detalles del recurso de organización que se acaba de crear.

  3. Debes acceder a tu cuenta de la Consola de APIs de Google y seguir las instrucciones para mover tu proyecto de la Consola de APIs de Google a la organización nueva.

  4. Responde el correo electrónico para informarle a Google que tus proyectos se trasladaron a la nueva organización.

  5. El equipo de Cumplimiento de Google revisará tu solicitud y te enviará un correo electrónico a la dirección de correo electrónico de contacto de la API con el estado de aprobación y detalles adicionales.

Modifica tus solicitudes a la API

Puedes modificar tu app para que deje de enviar el encabezado developer-token cuando realices llamadas a la API. Este es un paso opcional, pero se recomienda hacerlo. Si estás en el programa piloto, el servidor de la API de Google Ads ignora el developer-token si se envía como parte de las solicitudes a la API.

Java

Disponible próximamente

.NET

Descarga e instala la versión 17.1.0 o una posterior de la biblioteca .NET de la API de Google Ads.

A continuación, modifica el código de la siguiente manera:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

Disponible próximamente

Python

Disponible próximamente

Ruby

Disponible próximamente

Perl

Disponible próximamente

Cliente HTTP (REST)

Omite el encabezado developer-token en tus solicitudes HTTP:

curl -i -X POST https://googleads.googleapis.com/v18/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"

Preguntas frecuentes

¿Este cambio significa que debo ser cliente de Google Workspace o Google Cloud para usar la API de Google Ads?

No. Necesitas una organización de Google Cloud, que se puede obtener de muchas maneras. Este requisito es similar a la necesidad de tener un proyecto de la Consola de API de Google para usar la API de Google Ads en la actualidad.

Necesito cambiar mis niveles de acceso a la API. ¿Cómo puedo hacer esto?

Por ahora, debes seguir usando el Centro de APIs para solicitar cualquier cambio en los niveles de acceso a la API.

¿Hay algún tiempo de inactividad para habilitar esta prueba piloto?

No. La API de Google Ads comenzará a usar automáticamente los niveles de acceso a la API a nivel de la organización una vez que se apruebe.

¿Cuánto esfuerzo requiere participar en esta prueba piloto?

Se esperan cambios mínimos en el código. La mayoría de los desarrolladores deberían poder completar los cambios en su app en menos de 30 minutos.

¿Se me cobrará si participo en esta prueba piloto?

En general, no, no se te cobrará si aceptas participar en esta prueba piloto. La API de Google Ads se ofrece sin cargo, y Google no realizará ningún cambio en el modelo de precios de la API de Google Ads.

Las situaciones posibles para obtener una organización de Google Cloud son las siguientes:

  1. Si eres cliente existente de Google Workspace o Google Cloud Identity:

    Se te cobrará como de costumbre por el uso habitual de esos productos. No se te cobrará por crear una organización de Google Cloud con el fin de participar en esta prueba piloto.

  2. Creaste una cuenta de la edición gratuita de Google Cloud Identity:

    No se te cobrará cuando te registres en la cuenta de la edición gratuita de Google Cloud Identity ni cuando crees una organización de Google Cloud para participar en esta prueba piloto.

  3. Google creó un recurso de organización de Cloud por ti:

    Este es un recurso de organización interna de Cloud administrado por Google, por lo que no se te cobrará como resultado.

Tengo varios tokens de desarrollador para diferentes herramientas. ¿Cómo me afecta esta prueba piloto?

Este caso de uso no se admite, por lo que no podrás participar en esta prueba piloto.

¿Esto afecta alguna autorización de API existente para las cuentas que administro con la API de Google Ads?

No, este cambio no afecta las autorizaciones de API existentes para las cuentas de Google Ads que administras con la API de Google Ads.

Acepté participar en esta prueba piloto y tengo un problema o comentarios. ¿Cómo puedo comunicarme con el equipo de asistencia?

Comunícate con el equipo de la API de Google Ads a través de la página de asistencia técnica de la API y explica la naturaleza de tu problema. Cuando sea posible, incluye detalles como el ID de tu organización y los registros de solicitudes y respuestas.