Python

Google предоставляет клиентскую библиотеку Python для взаимодействия с API Менеджера рекламы. Мы рекомендуем использовать клиентскую библиотеку с PyPI.

Для начала создайте новый проект в выбранной вами IDE или добавьте зависимость к существующему проекту. Google публикует артефакты клиентской библиотеки в PyPI как google-ads-admanager .

pip install google-ads-admanager

Настройка учетных данных

Клиентская библиотека Python использует OAuth2 и учетные данные приложения по умолчанию (ADC) для аутентификации.

ADC ищет учетные данные по порядку в следующих местах:

1. Переменная среды GOOGLE_APPLICATION_CREDENTIALS .
2. Учетные данные пользователя, настроенные через Google Cloud CLI (gcloud CLI).
3. При работе в Google Cloud учетная запись службы привязывается к ресурсу Google Cloud.

Для создания и настройки учетных данных ADC см. раздел Аутентификация .

Сделайте свой первый запрос

Каждая служба имеет объект ServiceClient с синхронными и асинхронными методами для каждого метода REST. В следующем примере Network считывается синхронно.

from google.ads import admanager_v1


def sample_get_network():
    # Create a client
    client = admanager_v1.NetworkServiceClient()

    # Initialize request argument(s)
    request = admanager_v1.GetNetworkRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)
admanager_v1_generated_network_service_get_network_sync.py

Примеры других методов и ресурсов см. в репозитории GitHub googleapis/google-cloud-python .

Обработка ошибок

Все ошибки API расширяют базовый класс GoogleAPIError .

Поле причины ошибки однозначно идентифицирует типы ошибок. Используйте это поле, чтобы определить, как обработать ошибку.

try:
  network = client.get_network(request=request)
  print(network)
except GoogleAPIError as e:
  # Handle error
  print(e.reason)

Ошибки API Менеджера рекламы также включают уникальный requestId вы можете предоставить службе поддержки для устранения неполадок. В следующем примере requestId извлекается из GoogleAPIError ;

except GoogleAPIError as e:
  requestInfoType = "type.googleapis.com/google.rpc.RequestInfo"
  requestInfo = [detail for detail in e.details if detail['@type'] == requestInfoType][0]
  print(requestInfo['requestId'])

Настройте параметры прокси

Клиентская библиотека Python учитывает настройки переменных среды http_proxy и https_proxy .