Часто задаваемые вопросы

Общий

Какая последняя версия API?

Последняя версия API, рассматриваемая в этом документе, — v1beta2 . Эта версия представляет собой закрытую бета-версию, доступную для доверенных тестировщиков.

Кто может получить доступ к API?

Доступ к версии v1beta2 предоставляется только проектам консоли Google API, перечисленным в списке. Доступ к документации API контролируется отдельным списком разрешенных пользователей.

Как узнать, разрешен ли мой консольный проект для размещения в списке?

Select an API key from your project by clicking on the API_KEY element in the URL below. If an API key doesn't exist for the selected project, you'll be prompted to create one. When done, copy and paste the resulting URL into your browser.

https://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEY

Если вы видите JSON-описание API, значит, ваш проект разрешен для добавления в список. Если вы видите ошибку, значит, ваш проект не разрешен для добавления в список.

Использование API

Какой URL-адрес мне нужно использовать для доступа к API?

https://displayvideo.googleapis.com

Какие методы аутентификации поддерживаются?

OAuth 2.0 — единственный поддерживаемый метод аутентификации. Все запросы должны быть авторизованы в рамках следующей области действия:

  • https://www.googleapis.com/auth/display-video

Я хочу писать код. Где я могу найти клиентские библиотеки?

Python

Для доступа к этому API можно использовать общедоступную клиентскую библиотеку Google API для Python . Чтобы установить библиотеку и создать авторизованный объект сервиса, выполните следующие действия.

  1. Установите google-api-python-client

    pip install --upgrade google-api-python-client

  2. Получите объект авторизованных credentials . Пример см. в руководстве по настройке приложения .

  3. Создайте авторизованный объект службы, используя службу обнаружения.

    api_key = 'API_KEY'
api_name = 'displayvideo'
api_url = 'https://%s.googleapis.com/' % api_name
api_version = 'v1beta2'

discovery_url = (
    '%s/$discovery/rest?key=%s&version=%s&labels=%s'
    % (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER')
)

service = discovery.build(api_name, api_version,
                          discoveryServiceUrl=discovery_url,
                          http=credentials)