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:

  • 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 tienes que 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 deberás enviar un token de acceso.

  • Mantén proyectos separados de la Consola de APIs de Google 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 APIs de Google dentro de esta organización, como la administración detallada de proyectos, proyectos independientes para diferentes apps y varios proyectos de la Consola de APIs de Google para los miembros de tu equipo.

  • Supervisión y administración de cuotas más precisas: 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 debes tener un token de desarrollador aprobado para usar esta opción. Puedes encontrar un token de desarrollador existente en la página del Centro de API de tu cuenta de administrador de Google Ads. Accede y navega a HERRAMIENTAS Y CONFIGURACIÓN > CONFIGURACIÓN > Centro de API.

  • 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. Hay varias formas de crear una organización de Google Cloud.

    Situación Pasos
    Ser cliente existente de Google Workspace o Google Cloud Identity Es probable que ya tengas un recurso de organización. Puedes verificar y crear una si es necesario.
    No debes usar Google Workspace ni Google Cloud Identity Regístrate en la edición gratuita de Google Cloud Identity. Luego, crea tu recurso de organización.
    Ninguna de las opciones anteriores Explica tu situación cuando te registres en la prueba piloto y le solicites a Google que cree un recurso de organización por ti. Google será el propietario y administrador de este recurso de la organización sin cargo.

  • 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 utilizas con la API de Google Ads para el programa piloto de la siguiente manera:

    Situación Pasos
    Ya eres propietario de una organización de Google Cloud o creaste una en el paso anterior Asegúrate de que todos los proyectos de la Consola de API de Google en los que habilitaste la API de Google Ads estén en esta organización. De lo contrario, mígrala a la organización.

    Si ya eres cliente de Google Workspace o Google Cloud Identity, es posible que los proyectos de la Consola de API de Google ya estén en tu organización, por lo que puedes omitir este paso.
    No eres propietario de una organización de Google Cloud y no pudiste crear una en el paso anterior Asegúrate de ser usuario administrador de tu cuenta de administrador de la API de Google Ads y de 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 actualizada

    Asegúrese de que su correo electrónico de contacto de la API de Google Ads esté actualizado. Los detalles de contacto de la API se indican en la página del Centro de API de tu cuenta de administrador de la API de Google Ads. Accede y ve a HERRAMIENTAS Y CONFIGURACIÓN > CONFIGURACIÓN > Centro de API.

Registrarse en el programa piloto

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

Si le solicitaste a Google que creara una organización de Google Cloud para ti, debes seguir algunos pasos adicionales:

  1. Google creará un recurso de organización de Cloud propiedad de Google para ti. A todos los administradores de tu cuenta de administrador de la API de Google Ads se les otorgará la función 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 la organización recién creado.

  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 informar a Google que tus proyectos se trasladarán a la organización nueva.

  5. El equipo de cumplimiento de Google revisará tu solicitud y enviará un correo electrónico a tu 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 paso es opcional pero recomendado. Si formas parte del 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

Disponibles próximamente

.NET

Descarga y, luego, instala la versión 17.1.0 o una posterior de la biblioteca de .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

Disponibles próximamente

Python

Disponibles próximamente

Rita

Disponibles próximamente

Perl

Disponibles próximamente

Cliente HTTP (REST)

Omite el encabezado developer-token en tus solicitudes HTTP:

curl -i -X POST https://googleads.googleapis.com/v16/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 utilizar la API de Google Ads?

No. Necesitas una organización de Google Cloud que pueda obtenerse de varias formas. Este requisito es similar a como necesitas un proyecto de la Consola de APIs de Google para usar la API de Google Ads en la actualidad.

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

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

¿Hay algún tiempo de inactividad para participar en 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 se requiere para participar en esta prueba piloto?

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

¿Se me cobrará si habilito esta prueba piloto?

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

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

  1. Ya eres cliente de Google Workspace o Google Cloud Identity:

    Se te cobrará como de costumbre por el uso habitual de estos productos. No se te cobrará por crear una organización de Google Cloud con el propósito 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 una cuenta de la edición gratuita de Google Cloud Identity o por crear una organización de Google Cloud con el fin de participar en esta prueba piloto.

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

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

Tengo varios tokens de desarrollador para distintas 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 la API existente en las cuentas que administro mediante la API de Google Ads?

No, este cambio no afecta ninguna autorización de la API existente para las cuentas de Google Ads que administras a través de la API de Google Ads.

Participé 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 mediante la página de asistencia técnica de la API y explica la naturaleza del problema. Cuando sea posible, incluye detalles como el ID de la organización y los registros de solicitud y respuesta.