Mulai menggunakan CSS API

Berikut cara menggunakan CSS API:

Izin

Untuk menggunakan CSS API, Anda perlu mengonfigurasi izin di dua tempat: Google Cloud dan CSS Center.

  1. Google Cloud IAM:

    • Buat akun layanan di Konsol Google Cloud. Ikuti petunjuk yang serupa seperti untuk Content API untuk membuat dan mendownload file kredensial JSON. Langkah ini mengautentikasi akun layanan Anda sebagai entitas Google Cloud yang valid.
    • Jika menggunakan akses REST langsung atau library Klien Google API, Anda juga memerlukan Kunci API yang dibuat dari Konsol Google Cloud.

  2. CSS Center:

    • Alamat email akun layanan (misalnya, your-service-account-name@your-project-id.iam.gserviceaccount.com) harus ditambahkan sebagai pengguna dengan akses Admin ke akun CSS Center Anda. Langkah ini memberi otorisasi akun layanan untuk mengakses dan mengelola data Pusat CSS Anda.
    • Anda dapat memberikan akses di tingkat Grup CSS (untuk akses ke semua domain) atau ke akun Domain CSS tertentu. Untuk akses API, pemberian akses di tingkat Grup CSS adalah hal yang umum.
    • Untuk menambahkan akun layanan:
      • Login ke CSS Center dengan pengguna administrator.
      • Buka Akses akun (di bagian ikon roda gigi ⚙️).
      • Klik + Tambahkan pengguna, lalu masukkan email akun layanan.
      • Tetapkan tingkat akses ke Admin.
    • Izin mungkin memerlukan waktu hingga 30 menit untuk diterapkan. Jika Anda mengalami error izin, coba lagi nanti.

Cakupan Autentikasi:

Cakupan OAuth 2.0 yang diperlukan untuk CSS API adalah:

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

Pastikan aplikasi Anda meminta cakupan ini saat melakukan autentikasi.

Aktifkan CSS API

Untuk menggunakan CSS API, Anda harus mengaktifkannya di project Google Cloud Anda. Anda dapat menemukan library di https://console.cloud.google.com/apis/library/css.googleapis.com.

Mulai pemrograman

CSS API memiliki contoh kode, dan library klien untuk membantu Anda memulai. Kami juga memiliki halaman praktik terbaik.

Kirim permintaan

Kirim permintaan ke URL dalam format berikut:

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

Dengan {resource name} adalah nama resource yang terpengaruh oleh panggilan Anda.

Misalnya, berikut cara menghapus resource dengan gRPC:

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

Berikut cara menghapus resource dengan REST:

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

Lihat dokumentasi referensi CSS API untuk mengetahui detail selengkapnya tentang layanan tertentu.

Menggunakan gRPC atau REST

CSS API mendukung gRPC dan REST. Berikut adalah dua cara untuk melakukan panggilan CSS API:

gRPC (direkomendasikan) REST
  1. Buat isi permintaan sebagai buffer protokol.
  2. Kirim isi permintaan ke server dengan HTTP/2.
  3. Lakukan deserialisasi respons ke buffer protokol.
  4. Menginterpretasi hasil.
  1. Buat isi permintaan sebagai objek JSON.
  2. Kirim ke server menggunakan HTTP 1.1.
  3. Deserialisasi respons sebagai objek JSON.
  4. Menginterpretasi hasil.

Dapatkan bantuan

Hubungi perwakilan Google Anda untuk mendapatkan dukungan, atau gunakan formulir masukan untuk melaporkan masalah.

Berikut cara memberikan masukan lainnya jika Anda mengalami masalah:

Beri masukan

Untuk memberikan masukan, kirimkan salah satu hal berikut:

  • Fitur API: Kirimkan formulir masukan
  • Dokumentasi: Gunakan rating jempol di halaman dan tombol Kirim masukan.
  • Contoh dan library: Gunakan tombol Masalah baru di GitHub.

Untuk memberikan masukan umum setelah menerapkan setiap tugas, gunakan formulir masukan.

Sebelumnya
Ringkasan
Berikutnya
Praktik Terbaik