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.
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.
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.
- Adres e-mail konta usługi (np.
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 |
---|---|
|
|
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.