CSS API'yi kullanmaya başlama

CSS API'yi kullanmak için:

İzinler

CSS API ile çalışmak için izinleri iki yerde yapılandırmanız gerekir: Google Cloud ve CSS Center.

  1. Google Cloud IAM:

    • Google Cloud Console'da hizmet hesabı oluşturun. JSON kimlik bilgileri dosyasını oluşturmak ve indirmek için Content API ile ilgili talimatları uygulayın. Bu adımda, hizmet hesabınız geçerli bir Google Cloud öğesi olarak doğrulanır.
    • Doğrudan REST erişimi veya Google API istemci kitaplıklarını kullanıyorsanız Google Cloud Console'dan oluşturulan bir API anahtarına da ihtiyacınız vardır.

  2. CSS Center:

    • Hizmet hesabı e-posta adresi (ör. your-service-account-name@your-project-id.iam.gserviceaccount.com) CSS Center hesabınıza yönetici erişimi olan bir kullanıcı olarak eklenmelidir. Bu adım, hizmet hesabını CSS Merkezi verilerinize erişmesi ve bunları yönetmesi için yetkilendirir.
    • Erişimi CSS grubu düzeyinde (tüm alanlara erişim için) veya belirli CSS alanı hesaplarına verebilirsiniz. API erişimi için CSS grubu düzeyinde erişim izni verilmesi yaygın bir uygulamadır.
    • Hizmet hesabını eklemek için:
      • CSS Center'da yönetici kullanıcıyla oturum açın.
      • Hesap erişimi'ne (dişli simgesinin ⚙️ altında) gidin.
      • + Kullanıcı ekle'yi tıklayın ve hizmet hesabı e-posta adresini girin.
      • Erişim düzeyini Yönetici olarak ayarlayın.
    • İzinlerin uygulanması 30 dakikayı bulabilir. İzin hatalarıyla karşılaşırsanız daha sonra tekrar deneyin.

Kimlik Doğrulama Kapsamı:

CSS API için gerekli OAuth 2.0 kapsamı şöyledir:

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

Kimlik doğrulama sırasında uygulamanızın bu kapsamı istediğini doğrulayın.

CSS API'yi etkinleştirme

CSS API'yi kullanmak için Google Cloud projenizde etkinleştirmeniz gerekir. Kitaplığı https://console.cloud.google.com/apis/library/css.googleapis.com adresinde bulabilirsiniz.

Programlamaya başlama

CSS API'sinde, başlamanıza yardımcı olacak kod örnekleri ve istemci kitaplıkları bulunur. Ayrıca bir en iyi uygulamalar sayfamız da var.

İstekleri gönder

Aşağıdaki biçimde URL'lere istek gönderin:

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

Burada {resource name}, çağrınızın etkilediği kaynağın adıdır.

Örneğin, gRPC ile bir kaynağı silme işlemi şu şekilde yapılır:

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

REST ile kaynak silme işlemi şu şekilde yapılır:

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

Belirli hizmetler hakkında daha fazla bilgi için CSS API referans belgelerine göz atın.

gRPC veya REST kullanma

CSS API, gRPC ve REST'i destekler. CSS API çağrıları yapmanın iki yolu vardır:

gRPC (önerilir) REST
  1. İsteğin gövdesini protokol arabelleği olarak oluşturun.
  2. İstek gövdesini HTTP/2 ile sunucuya gönderin.
  3. Yanıtı protokol arabelleğine seri durumdan çıkarma.
  4. Sonuçları yorumlama.
  1. İsteğin gövdesini JSON nesnesi olarak oluşturun.
  2. HTTP 1.1 kullanarak sunucuya gönderin.
  3. Yanıtı JSON nesnesi olarak seri durumdan çıkarma.
  4. Sonuçları yorumlama.

Yardım alın

Destek için Google temsilcinizle iletişime geçin veya sorunları bildirmek üzere geri bildirim formunu kullanın.

Sorun yaşarsanız nasıl daha fazla geri bildirim gönderebileceğinizi aşağıda açıklıyoruz:

Geri bildirim gönder

Geri bildirimde bulunmak için aşağıdakilerden birini gönderin:

  • API özellikleri: Geri bildirim formunu gönderin.
  • Dokümanlar: Sayfa içi beğenme/beğenmeme puanlarını ve Geri bildirim gönder düğmesini kullanın.
  • Örnekler ve kitaplıklar: GitHub'da Yeni sorun düğmesini kullanın.

Her görevi uyguladıktan sonra genel geri bildirimde bulunmak için geri bildirim formunu kullanın.

Önceki
Genel bakış
Sonraki
En İyi Uygulamalar