Начните работу с CSS API

Вот как использовать CSS API:

Разрешения

Для работы с CSS API необходимо настроить разрешения в двух местах: Google Cloud и CSS Center.

  1. Google Cloud IAM:

    • Создайте учётную запись сервиса в консоли Google Cloud . Следуйте инструкциям, аналогичным инструкциям для Content API , чтобы создать и загрузить файл учётных данных JSON. Этот шаг аутентифицирует вашу учётную запись сервиса как допустимую сущность Google Cloud.
    • Если вы используете прямой доступ REST или клиентские библиотеки Google API, вам также понадобится ключ API, сгенерированный из Google Cloud Console.

  2. Центр CSS:

    • Адрес электронной почты сервисной учётной записи (например, your-service-account-name@your-project-id.iam.gserviceaccount.com ) должен быть добавлен в качестве пользователя с правами администратора вашей учётной записи CSS-центра. Этот шаг разрешит сервисной учётной записи доступ к данным CSS-центра и управление ими.
    • Вы можете предоставить доступ на уровне группы CSS (для доступа ко всем доменам) или к определенным учётным записям домена CSS. Для доступа через API предоставление доступа на уровне группы CSS является распространённой практикой.
    • Чтобы добавить учетную запись службы:
      • Войдите в CSS Center как администратор.
      • Перейдите в раздел «Доступ к учетной записи» (под значком шестеренки ⚙️).
      • Нажмите + Добавить пользователя и введите адрес электронной почты учетной записи службы.
      • Установите уровень доступа Администратор .
    • Распространение разрешений может занять до 30 минут. Если возникнут ошибки, повторите попытку позже.

Область аутентификации:

Требуемая область действия OAuth 2.0 для CSS API:

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

Убедитесь, что ваше приложение запрашивает эту область при аутентификации.

Включить CSS API

Чтобы использовать CSS API, необходимо включить его в вашем проекте Google Cloud. Библиотеку можно найти по адресу https://console.cloud.google.com/apis/library/css.googleapis.com .

Начать программирование

CSS API содержит примеры кода и клиентские библиотеки , которые помогут вам начать работу. У нас также есть страница с рекомендациями .

Отправлять запросы

Отправляйте запросы на URL-адреса в следующем формате:

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

Где {resource name} — имя ресурса, на который влияет ваш вызов.

Например, вот как удалить ресурс с помощью gRPC:

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

Вот как удалить ресурс с помощью REST:

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

Более подробную информацию о конкретных сервисах см. в справочной документации CSS API.

Используйте gRPC или REST

CSS API поддерживает gRPC и REST . Вот два способа выполнения вызовов CSS API:

gRPC (рекомендуется) ОТДЫХ
  1. Создайте тело запроса как буфер протокола.
  2. Отправьте тело запроса на сервер по протоколу HTTP/2.
  3. Десериализуйте ответ в буфер протокола.
  4. Интерпретируйте результаты.
  1. Создайте тело запроса как JSON-объект.
  2. Отправьте его на сервер, используя HTTP 1.1.
  3. Десериализуйте ответ как объект JSON.
  4. Интерпретируйте результаты.

Получить помощь

Обратитесь за поддержкой к представителю Google или воспользуйтесь формой обратной связи, чтобы сообщить о любых проблемах.

Вот как вы можете предоставить дополнительную обратную связь, если у вас возникнут проблемы:

Оставьте отзыв

Чтобы оставить отзыв, отправьте один из следующих вариантов:

  • Возможности API: Отправьте форму обратной связи
  • Документация: используйте встроенные оценки и кнопку «Отправить отзыв» .
  • Образцы и библиотеки: используйте кнопку «Новый выпуск» на GitHub.

Для предоставления общей обратной связи после выполнения каждой задачи воспользуйтесь формой обратной связи .

Назад
Обзор
Далее
Рекомендации