Comienza a usar la API de CSS

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.

  1. Google Cloud IAM:

  2. 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.

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
  1. Crea el cuerpo de la solicitud como un búfer de protocolo.
  2. Envía el cuerpo de la solicitud al servidor con HTTP/2.
  3. Deserializa la respuesta en un búfer de protocolo.
  4. Interpreta los resultados.
  1. Crea el cuerpo de la solicitud como un objeto JSON.
  2. Envía la solicitud al servidor con HTTP 1.1.
  3. Deserializa la respuesta como un objeto JSON.
  4. Interpreta los resultados.

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.