Google предоставляет клиентскую библиотеку Python для взаимодействия с API Менеджера рекламы. Мы рекомендуем использовать клиентскую библиотеку с PyPI.
Для начала создайте новый проект в выбранной вами IDE или добавьте зависимость к существующему проекту. Google публикует артефакты клиентской библиотеки в PyPI как google-ads-admanager
.
pip install google-ads-admanager
Настройка учетных данных
Клиентская библиотека Python использует OAuth2 и учетные данные приложения по умолчанию (ADC) для аутентификации.
ADC ищет учетные данные по порядку в следующих местах:
- Переменная среды
GOOGLE_APPLICATION_CREDENTIALS
. - Учетные данные пользователя, настроенные через Google Cloud CLI (gcloud CLI).
- При работе в 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)
Примеры других методов и ресурсов см. в репозитории 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
.
Google предоставляет клиентскую библиотеку Python для взаимодействия с API Менеджера рекламы. Мы рекомендуем использовать клиентскую библиотеку с PyPI.
Для начала создайте новый проект в выбранной вами среде IDE или добавьте зависимость к существующему проекту. Google публикует артефакты клиентской библиотеки в PyPI как google-ads-admanager
.
pip install google-ads-admanager
Настройка учетных данных
Клиентская библиотека Python использует OAuth2 и учетные данные приложения по умолчанию (ADC) для аутентификации.
ADC ищет учетные данные по порядку в следующих местах:
- Переменная среды
GOOGLE_APPLICATION_CREDENTIALS
. - Учетные данные пользователя, настроенные через Google Cloud CLI (gcloud CLI).
- При работе в 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)
Примеры других методов и ресурсов см. в репозитории 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
.