Стандартные параметры запроса

В таблице ниже представлены параметры запроса, применимые ко всем операциям с API управления AdSense.

Примечания (касательно ключей API и токенов авторизации)

  1. Параметр key требуется при каждом запросе, если только вы не предоставили токен OAuth 2.0.
  2. Токен авторизации обязательно нужно отправлять при каждом запросе с пометкой (AUTHENTICATED). OAuth 2.0 является предпочтительным протоколом авторизации.
  3. Предоставить токен OAuth 2.0 в запросе можно двумя способами:
    • используя параметр запроса access_token, например: ?access_token=oauth2-token;
    • используя HTTP-заголовок Authorization, например: Authorization: Bearer oauth2-token.

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

Параметр Назначение Примечания
access_token Токен OAuth 2.0 для текущего пользователя.
callback Функция обратного вызова.
  • Название функции обратного вызова JavaScript, обрабатывающей ответ.
  • Используется в запросах JavaScript JSON-P.
fields Селектор, определяющий набор полей для включения в ответ.
  • Подробнее читайте в разделе Частичный ответ статьи "Повышение эффективности".
  • Используется для повышения эффективности.
key Ключ API (ОБЯЗАТЕЛЬНО*).
  • *Обязательный параметр, если не предоставлен токен OAuth 2.0.
  • Ключ API служит идентификатором вашего проекта и предоставляет вам доступ к API, квотам и отчетам.
  • Ключ API для проекта можно получить в Консоли Google Developers.
prettyPrint

Возвращает ответ с отступами и переносами строки.

  • Возвращает ответ в удобном для пользователя формате, если значение равно true.
  • Значение по умолчанию: false.
  • Значение false может уменьшить информационное наполнение ответа, что повышает быстродействие в некоторых средах.
quotaUser Альтернатива параметру userIp.
  • Позволяет извлечь пользовательские квоты из приложения на стороне сервера, даже если IP-адрес пользователя неизвестен (например, если приложение от имени пользователя выполняет задания с экономией времени на платформе Google App Engine).
  • Вы можете выбрать любую строку, уникально идентифицирующую пользователя, однако ее длина не должна превышать 40 символов.
  • Переопределяет userIp, если указаны оба параметра.
  • Подробнее об ограничениях…
userIp IP-адрес конечного пользователя, от имени которого выполняется вызов API.

Оставить отзыв о...

Текущей странице
AdSense Management API
AdSense Management API