API Google Ads Transparency Center
Google Ads Transparency Center показывает объявления проверенных рекламодателей в Google Поиске, YouTube, Google Play, Картах и Shopping. ads выдаёт до 100 объявлений одного рекламодателя, найденного по домену или идентификатору рекламодателя.
Передайте в advertiser домен, например lululemon.com, или идентификатор рекламодателя, начинающийся с AR. Объявления перечислены приблизительно в порядке убывания даты последнего показа. Записи не содержат текста объявления, данных о расходах или числе показов; чтобы увидеть креатив, откройте url или image_url. advertiser_name — подтверждённое название, это может быть дочерняя компания или агентство. Отображаются только рекламодатели, прошедшие проверку Google.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Google Ads Transparency Center: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Рекламаads | Получайте до 100 объявлений, которые компания показывала в Google, из Google Ads Transparency Center: передайте домен или ID рекламодателя в advertiser. | $0.68 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Google Ads Transparency Center?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
adsРеклама Получайте до 100 объявлений, которые компания показывала в Google, из Google Ads Transparency Center: передайте домен или ID рекламодателя в | advertiser | country, end_date, format, start_date, surface | Режим выдачи: Sync | Значения в каталоге: defaultLimit=100, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.68 за 1 000 запросов | rank · ad_id · advertiser_id · advertiser_name · domain · format · first_shown_at · last_shown_at · image_url · url · advertiser_ads_estimate · platform |
Что означают параметры действия ads в API Google Ads Transparency Center?
Получайте до 100 объявлений, которые компания показывала в Google, из Google Ads Transparency Center: передайте домен или ID рекламодателя в advertiser. В каждой записи есть ID объявления, формат (текст, изображение или видео), время первого и последнего показа, изображение предпросмотра и ссылка на объявление в Transparency Center. Фильтруйте по country, format, surface и датам первого показа. Расходы и показы не включаются.
advertiserОбязательный- Чью рекламу выводить: домен, например
nike.com, или ID рекламодателя, начинающийся с AR, напримерAR01614014350098432001. Подойдёт и ссылка на рекламодателя в Transparency Center.Справка «Мой центр рекламы»: верификация рекламодателей и Ads Transparency Center — На странице справки Google сказано, что рекламодатели должны подтвердить свою личность юридическими документами, а в Ads Transparency Center можно искать по имени рекламодателя или сайту и фильтровать по региону показа и датам. Источник подтверждает поиск по домену или рекламодателю и фильтрацию по стране и датам; параметры этого API определены EveryInfra, и источник не ручается за результаты. · Проверено countryНеобязательный- Двухбуквенный код страны, например
usилиgb, чтобы оставить только рекламу, показанную в этой стране. Без параметра учитываются все регионы. end_dateНеобязательный- Оставить только рекламу, впервые показанную в эту дату или раньше, в формате YYYY-MM-DD; не раньше
start_date. formatНеобязательный- Оставить только один формат рекламы:
text,imageилиvideo.Допустимые значения:imagetextvideo start_dateНеобязательный- Оставить только рекламу, впервые показанную в эту дату или позже, в формате YYYY-MM-DD.
surfaceНеобязательный- Оставить только рекламу, показанную в одном продукте Google:
search,youtube,play,mapsилиshopping.
Как использовать API Google Ads Transparency Center
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_ads_transparency","action":"ads","params":{"advertiser":"<advertiser>"}}'
Вопросы об API Google Ads Transparency Center
Какие данные можно получить через API Google Ads Transparency Center?
Укажите в platform значение google_ads_transparency. В текущем каталоге: реклама. Эти названия действий соответствуют разным объектам или представлениям Google Ads Transparency Center; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса ads к платформе Google Ads Transparency Center?
Чью рекламу выводить: домен, например nike.com, или ID рекламодателя, начинающийся с AR, например AR01614014350098432001. Подойдёт и ссылка на рекламодателя в Transparency Center. Передайте это значение в поле advertiser объекта params.
Какие поля может вернуть ads на платформе Google Ads Transparency Center?
Объявленная схема включает rank, ad_id, advertiser_id и advertiser_name. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Google Ads Transparency Center возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.