Niveles de acceso administrados en la nube

Nota: Google acepta postulantes a este programa. Regístrate.

Esta función permite que un equipo de Google Cloud administre tus niveles de acceso a la API de Google Workspace, 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 la seguridad tokens de desarrollador ni filtrarlos. Puede omitir el envío de su token de desarrollador en tus llamadas a la API, aunque todavía debes enviar un token de acceso.

• Mantén proyectos separados de la Consola de APIs de Google para diferentes apps: Todos los proyectos vinculados a la organización de Google Cloud heredan la API nivel de acceso de la organización. Esto te permite crear múltiples Los proyectos de la Consola de APIs de Google en esta organización para propósitos como administración de proyectos detallada, proyectos separados 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 la API. uso 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. Tú puedes encontrar un token de desarrollador existente en la página Centro de API de tu cuenta de administrador de Google Ads. Acceder, luego navega a HERRAMIENTAS Y CONFIGURACIÓN > CONFIGURAR > Centro de APIs.

• Una organización de Google Cloud

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

  Situación	Pasos
  Ya tienes una cuenta de Google Workspace o Google Cloud Cliente de identidad	Es probable que ya tengas un recurso de organización. Puedes Cheques y crea una si es necesario.
  Si no usas Google Workspace o Google Cloud Identity	Regístrate para obtener la edición gratuita de Google Cloud Identity. Luego crear el recurso de tu organización.
  Ninguna de las opciones anteriores te resulta útil	Explica la situación cuando firmas para la prueba piloto y solicitarle a Google que cree un recurso de organización por ti. Google será propietario y administrador de este recurso de la organización sin y cargar.

• 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 la paso anterior	Asegúrate de que todos los proyectos de la Consola de APIs de Google en los que hayas habilitado las La API de Google Ads pertenece a esta organización. Si no lo está, migrala dentro de la organización. Si ya tienes una cuenta de Workspace o Google Cloud Identity, es posible que los proyectos de la Consola de APIs de Google que ya pertenece a tu organización, por lo que puedes omitir este paso.
  No eres propietario de una organización de Google Cloud y no puedes crear una en el paso anterior	Asegúrese de ser usuario administrador en su administrador de la API de Google Ads y tu proyecto de la Consola de APIs de Google. Necesitas este permiso para realizar pasos adicionales después de que se apruebe tu solicitud piloto.

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

  Asegúrese de que su correo electrónico de contacto de la API de Google Ads esté actualizado. Tu contacto de la API se incluyen en la página del Centro de la API de su cuenta de administrador de la API de Google Ads. Accede, luego navega a HERRAMIENTAS y CONFIGURACIÓN > CONFIGURAR > Centro de APIs.

Registrarse en el programa piloto

Regístrate en el programa piloto. El equipo de Cumplimiento de Google Luego, revisa tu solicitud y envía 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 por ti, puedes debes seguir algunos pasos adicionales:

1. Google creará un recurso de organización de Cloud de propiedad de Google para ti. Todo a los administradores de tu cuenta de administrador de la API de Google Ads se les otorgará la Rol roles/resourcemanager.projectCreator en la app recién creada organización.

2. Google enviará un correo electrónico a tu dirección de correo electrónico de contacto de la API con los detalles de la 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 nueva organización.

4. Responde el correo electrónico para informar a Google que tus proyectos se trasladan al en tu nueva organización.

5. El equipo de cumplimiento de Google revisará tu solicitud y enviará tu API por correo electrónico. dirección de correo electrónico de contacto 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 realizar llamadas a la API. Este paso es opcional, pero recomendado. 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

Descargue e instale la versión 17.1.0 o una más reciente de la API de Google Ads .NET biblioteca.

A continuación, modifica tu 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

Rita

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/v17/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 implica 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 pueda obtener en muchos maneras. Este requisito es similar al que necesitas de la Consola de APIs de Google para usar la API de Google Ads hoy mismo.

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

Debes continuar usando el Centro de APIs por ahora para solicitar cambios en el Niveles de acceso a la API.

¿Hay tiempo de inactividad por participar en esta prueba piloto?

No. La API de Google Ads comenzará a utilizar 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?

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

¿Se me cobrará si habilito 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 realiza ningún cambio en la API de Google Ads de precios.

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

1. Eres cliente existente de Google Workspace o Google Cloud Identity:

   Se le cobrará como de costumbre por el uso habitual de esos productos. Tú no se cobrará por crear una organización de Google Cloud con el objetivo de que participa 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 edición gratuita de Google Cloud Identity o crear una organización de Google Cloud con el objetivo de que participa en esta prueba piloto.

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

   Este es un recurso interno de la organización 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 la prueba piloto?

No podrás participar en él porque no se admite este caso de uso. piloto.

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

No, este cambio no afecta ninguna autorización de API existente en la cuenta de Google Ads cuentas que administra con 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íquese con el equipo de la API de Google Ads a través de la asistencia técnica de API y explica la naturaleza del problema. Incluir detalles como el ID de tu organización y los registros de solicitud y respuesta cuando como sea posible.