Gmail Postmaster Tools API

API Postmaster Tools — это RESTful API, предоставляющий программный доступ к показателям трафика электронной почты (таким как отчеты о спаме, ошибки доставки и т. д.), которые в настоящее время доступны только через пользовательский интерфейс Gmail Postmaster Tools.

Сервис: gmailpostmastertools.googleapis.com

Для вызова этой службы мы рекомендуем использовать клиентские библиотеки, предоставляемые Google. Если вашему приложению необходимо использовать собственные библиотеки для вызова этой службы, используйте следующую информацию при отправке запросов к API.

Документ об обнаружении

Документ Discovery — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов для IDE и других инструментов, взаимодействующих с API Google. Один сервис может предоставлять несколько документов Discovery. Данный сервис предоставляет следующий документ Discovery:

конечная точка сервиса

Конечная точка сервиса — это базовый URL-адрес, указывающий сетевой адрес API-сервиса. Один сервис может иметь несколько конечных точек. Данный сервис имеет следующую конечную точку, и все приведенные ниже URI являются относительными к этой конечной точке:

  • https://gmailpostmastertools.googleapis.com

REST-ресурс: v2beta.domainStats

Методы
batchQuery POST /v2beta/domainStats:batchQuery
Выполняет пакет запросов QueryDomainStats для нескольких доменов.

REST-ресурс: v2beta.domains

Методы
create POST /v2beta/domains
Добавляет домен к учетной записи пользователя.
delete DELETE /v2beta/{name=domains/*}
Удаляет домен из учетной записи пользователя.
get GET /v2beta/{name=domains/*}
Получает подробную информацию о зарегистрированном вами домене.
getComplianceStatus GET /v2beta/{name=domains/*/complianceStatus}
Получает информацию о соответствии требованиям для заданного домена.
getVerificationToken GET /v2beta/{name=domains/*/verificationToken}
Получает токен подтверждения, используемый для проверки права собственности пользователя на домен.
list GET /v2beta/domains
Получает список всех зарегистрированных вами доменов, а также соответствующие им метаданные.
verify POST /v2beta/{name=domains/*}:verify
Проверяет право собственности пользователя на домен на уровне DNS.

REST-ресурс: v2beta.domains.domainStats

Методы
query POST /v2beta/{parent=domains/*}/domainStats:query
Получает список статистических данных по домену за заданный домен и период времени.

REST-ресурс: v2beta.domains.users

Методы
create POST /v2beta/{parent=domains/*}/users
Создаёт пользователя, имеющего доступ к домену.
delete DELETE /v2beta/{name=domains/*/users/*}
Удаляет пользователя из домена.
get GET /v2beta/{name=domains/*/users/*}
Получает подробную информацию о пользователе, имеющем доступ к домену.
list GET /v2beta/{parent=domains/*}/users
Отображает список пользователей, имеющих доступ к домену.
patch PATCH /v2beta/{user.name=domains/*/users/*}
Обновляет данные пользователя для домена.