Sigue estos pasos para usar la API de CSS:
Permisos
Para trabajar con la API de CSS, debes configurar permisos en dos lugares: Google Cloud y CSS Center.
Google Cloud IAM:
- Crea una cuenta de servicio en la consola de Google Cloud. Sigue instrucciones similares a las de la API de Content para crear y descargar el archivo de credenciales JSON. En este paso, se autentica tu cuenta de servicio como una entidad válida de Google Cloud.
- Si usas acceso directo a REST o las bibliotecas cliente de la API de Google, también necesitas una clave de API generada desde la consola de Google Cloud.
CSS Center:
- La dirección de correo electrónico de la cuenta de servicio (p.ej.,
your-service-account-name@your-project-id.iam.gserviceaccount.com
) debe agregarse como usuario con acceso de administrador a tu cuenta de CSS Center. Este paso autoriza a la cuenta de servicio a acceder a tus datos del Centro de CSS y administrarlos. - Puedes otorgar acceso a nivel del grupo de CSS (para acceder a todos los dominios) o a cuentas de dominio de CSS específicas. Para el acceso a la API, es común otorgar acceso a nivel del grupo de CSS.
- Para agregar la cuenta de servicio, haz lo siguiente:
- Accede a CSS Center con un usuario administrador.
- Navega a Acceso a la cuenta (en el ícono de ajustes ⚙️).
- Haz clic en + Agregar usuario y, luego, ingresa el correo electrónico de la cuenta de servicio.
- Establece el nivel de acceso en Administrador.
- Es posible que los permisos tarden hasta 30 minutos en propagarse. Si encuentras errores de permisos, vuelve a intentarlo más tarde.
- La dirección de correo electrónico de la cuenta de servicio (p.ej.,
Alcance de la autenticación:
El permiso de OAuth 2.0 requerido para la API de CSS es el siguiente:
https://www.googleapis.com/auth/content
Verifica que tu aplicación solicite este alcance durante la autenticación.
Habilita la API de CSS
Para usar la API de CSS, debes habilitarla en tu proyecto de Google Cloud. Puedes encontrar la biblioteca en https://console.cloud.google.com/apis/library/css.googleapis.com.
Comienza a programar
La API de CSS tiene muestras de código y bibliotecas cliente para ayudarte a comenzar. También tenemos una página de prácticas recomendadas.
Envía solicitudes
Envía solicitudes a URLs con el siguiente formato:
https://css.googleapis.com/{version}/{resource name}:{method}…
Donde {resource name}
es el nombre del recurso en el que influye tu llamada.
Por ejemplo, a continuación, se muestra cómo borrar un recurso con gRPC:
https://css.googleapis.com/v1/{resource name}:delete
A continuación, te mostramos cómo borrar un recurso con REST:
DELETE https://css.googleapis.com/v1/{resource name}
Consulta la documentación de referencia de la API de CSS para obtener más detalles sobre servicios específicos.
Usa gRPC o REST
La API de CSS admite gRPC y REST. Estas son las dos formas de realizar llamadas a la API de CSS:
gRPC (recomendado) | REST |
---|---|
|
|
Obtener ayuda
Comunícate con tu representante de Google para obtener asistencia o usa el formulario de comentarios para informar cualquier problema.
Si tienes problemas, puedes proporcionar más comentarios de la siguiente manera:
Enviar comentarios
Para enviar comentarios, proporciona uno de los siguientes elementos:
- Funciones de la API: Envía el formulario de comentarios
- Documentación: Usa las calificaciones con pulgares en la página y el botón Enviar comentarios.
- Muestras y bibliotecas: Usa el botón New issue en GitHub.
Para proporcionar comentarios generales después de implementar cada tarea, usa el formulario de comentarios.