Premiers pas avec l'API CSS

Voici comment utiliser l'API CSS :

Autorisations

Pour utiliser l'API CSS, vous devez configurer les autorisations à deux endroits : Google Cloud et CSS Center.

  1. Google Cloud IAM :

    • Créez un compte de service dans la console Google Cloud. Suivez des instructions similaires à celles de l'API Content pour créer et télécharger le fichier d'identifiants JSON. Cette étape authentifie votre compte de service en tant qu'entité Google Cloud valide.
    • Si vous utilisez un accès REST direct ou les bibliothèques clientes des API Google, vous avez également besoin d'une clé API générée à partir de la console Google Cloud.

  2. CSS Center :

    • Adresse e-mail du compte de service (par exemple, your-service-account-name@your-project-id.iam.gserviceaccount.com) doit être ajouté en tant qu'utilisateur avec accès administrateur à votre compte CSS Center. Cette étape autorise le compte de service à accéder à vos données CSS Center et à les gérer.
    • Vous pouvez accorder l'accès au niveau du groupe CSS (pour accéder à tous les domaines) ou à des comptes de domaine CSS spécifiques. Pour l'accès à l'API, il est courant d'accorder l'accès au niveau du groupe CSS.
    • Pour ajouter le compte de service :
      • Connectez-vous à CSS Center en tant qu'administrateur.
      • Accédez à Accès au compte (sous l'icône en forme de roue dentée ⚙️).
      • Cliquez sur + Ajouter un utilisateur, puis saisissez l'adresse e-mail du compte de service.
      • Définissez le niveau d'accès sur Administrateur.
    • La propagation des autorisations peut prendre jusqu'à 30 minutes. Si vous rencontrez des erreurs d'autorisation, réessayez plus tard.

Champ d'application de l'authentification :

Le champ d'application OAuth 2.0 requis pour l'API CSS est le suivant :

  • https://www.googleapis.com/auth/content

Vérifiez que votre application demande ce champ d'application lors de l'authentification.

Activer l'API CSS

Pour utiliser l'API CSS, vous devez l'activer dans votre projet Google Cloud. Vous trouverez la bibliothèque à l'adresse https://console.cloud.google.com/apis/library/css.googleapis.com.

Commencer à programmer

L'API CSS propose des exemples de code et des bibliothèques clientes pour vous aider à vous lancer. Nous avons également une page sur les bonnes pratiques.

Envoyer des requêtes

Envoyez des requêtes aux URL au format suivant :

https://css.googleapis.com/{version}/{resource name}:{method}…

où {resource name} est le nom de la ressource concernée par votre appel.

Par exemple, voici comment supprimer une ressource avec gRPC :

https://css.googleapis.com/v1/{resource name}:delete

Voici comment supprimer une ressource avec REST :

DELETE https://css.googleapis.com/v1/{resource name}

Pour en savoir plus sur des services spécifiques, consultez la documentation de référence de l'API CSS.

Utiliser gRPC ou REST

L'API CSS est compatible avec gRPC et REST. Voici les deux façons d'effectuer des appels d'API CSS :

gRPC (recommandé) REST
  1. Créez le corps de la requête en tant que tampon de protocole.
  2. Envoyez le corps de la requête au serveur avec HTTP/2.
  3. Désérialisez la réponse dans un tampon de protocole.
  4. Interprétez les résultats.
  1. Créez le corps de la requête en tant qu'objet JSON.
  2. Envoyez-le au serveur à l'aide de HTTP 1.1.
  3. Désérialisez la réponse en tant qu'objet JSON.
  4. Interprétez les résultats.

Obtenir de l'aide

Contactez votre représentant Google pour obtenir de l'aide ou utilisez le formulaire de commentaires pour signaler tout problème.

Voici comment nous faire part de vos commentaires si vous rencontrez des problèmes :

Envoyer des commentaires

Pour envoyer des commentaires, procédez comme suit :

  • Fonctionnalités de l'API : envoyez le formulaire de commentaires.
  • Documentation : utilisez les évaluations par pouce en haut de page et le bouton Envoyer des commentaires.
  • Exemples et bibliothèques : utilisez le bouton Nouveau problème sur GitHub.

Pour nous faire part de vos commentaires généraux après avoir effectué chaque tâche, utilisez le formulaire de commentaires.

Précédent
Aperçu
Suivant
Bonnes pratiques