Pierwsze kroki z interfejsem CSS API

Aby korzystać z interfejsu CSS API:

Uprawnienia

Aby korzystać z interfejsu CSS API, musisz skonfigurować uprawnienia w 2 miejscach: w Google Cloud i CSS Center.

  1. Google Cloud IAM:

    • Utwórz konto usługi w Google Cloud Console. Postępuj zgodnie z podobnymi instrukcjami jak w przypadku interfejsu Content API, aby utworzyć i pobrać plik JSON z danymi logowania. Ten krok uwierzytelnia konto usługi jako prawidłowy podmiot Google Cloud.
    • Jeśli korzystasz z bezpośredniego dostępu REST lub bibliotek klienta interfejsu API Google, potrzebujesz też klucza API wygenerowanego w konsoli Google Cloud.
  2. CSS Center:

    • Adres e-mail konta usługi (np. your-service-account-name@your-project-id.iam.gserviceaccount.com) musi zostać dodany jako użytkownik z dostępem administracyjnym do Twojego konta CSS Center. Ten krok autoryzuje konto usługi do uzyskiwania dostępu do danych w CSS Center i zarządzania nimi.
    • Możesz przyznać dostęp na poziomie grupy usług porównywania cen (aby uzyskać dostęp do wszystkich domen) lub do konkretnych kont domen usług porównywania cen. W przypadku dostępu do interfejsu API często przyznaje się dostęp na poziomie grupy usług porównywania cen.
    • Aby dodać konto usługi:
      • Zaloguj się w CSS Center jako administrator.
      • Otwórz Dostęp do konta (kliknij ikonę koła zębatego ⚙️).
      • Kliknij + Dodaj użytkownika i wpisz adres e-mail konta usługi.
      • Ustaw poziom dostępu na Administrator.
    • Rozpowszechnienie uprawnień może potrwać do 30 minut. Jeśli napotkasz błędy uprawnień, spróbuj ponownie później.

Zakres uwierzytelniania:

Wymagany zakres protokołu OAuth 2.0 dla interfejsu CSS API to:

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

Sprawdź, czy podczas uwierzytelniania aplikacja wysyła prośbę o ten zakres.

Włączanie interfejsu CSS API

Aby korzystać z interfejsu CSS API, musisz go włączyć w projekcie Google Cloud. Bibliotekę znajdziesz na stronie https://console.cloud.google.com/apis/library/css.googleapis.com.

Rozpocznij programowanie

Interfejs CSS API ma przykłady kodu i biblioteki klienta, które pomogą Ci rozpocząć pracę. Mamy też stronę ze sprawdzonymi metodami.

Prześlij prośby

Wysyłaj żądania na adresy URL w tym formacie:

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

gdzie {resource name} to nazwa zasobu, na który wpływa wywołanie.

Oto przykład usuwania zasobu za pomocą gRPC:

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

Aby usunąć zasób za pomocą interfejsu REST:

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

Więcej informacji o poszczególnych usługach znajdziesz w dokumentacji referencyjnej interfejsu CSS API.

Używanie gRPC lub REST

Interfejs CSS API obsługuje gRPC i REST. Wywołania interfejsu CSS API można wykonywać na 2 sposoby:

gRPC (zalecane) REST
  1. Utwórz treść żądania jako bufor protokołu.
  2. Wyślij treść żądania do serwera za pomocą protokołu HTTP/2.
  3. Zdeserializuj odpowiedź do bufora protokołu.
  4. Zinterpretuj wyniki.
  1. Utwórz treść żądania jako obiekt JSON.
  2. Wyślij go na serwer za pomocą protokołu HTTP 1.1.
  3. Zdeserializuj odpowiedź jako obiekt JSON.
  4. Zinterpretuj wyniki.

Pomoc

Aby uzyskać pomoc, skontaktuj się ze swoim przedstawicielem Google lub zgłoś problemy za pomocą formularza opinii.

Jeśli napotkasz problemy, możesz przesłać dodatkowe opinie w ten sposób:

Prześlij opinię

Aby przesłać opinię, wykonaj jedną z tych czynności:

  • Funkcje interfejsu API: przesyłanie formularza opinii
  • Dokumentacja: użyj ocen w postaci kciuka w górę lub w dół na stronie oraz przycisku Prześlij opinię.
  • Przykłady i biblioteki: użyj przycisku Nowy problem na GitHubie.

Aby przesłać ogólną opinię po wykonaniu każdego zadania, użyj formularza opinii.