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

Общий

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

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

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

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

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

Выберите ключ API из своего проекта, щелкнув элемент API_KEY в URL-адресе ниже. Если ключ API для выбранного проекта не существует, вам будет предложено его создать. Когда закончите, скопируйте и вставьте полученный URL-адрес в свой браузер.

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

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

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

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

https://displayvideo.googleapis.com

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

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

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

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

Питон

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

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

    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)