Новый API отчетов Search Ads 360 теперь доступен. Присоединяйтесь к группе Google searchads-api-announcements , чтобы быть в курсе предстоящих улучшений и выпусков.
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Иерархия имен
Имена ресурсов, используемые в API отчетов Search Ads 360, имеют иерархическую структуру, отражающую организацию объектов в Search Ads 360. Почти все ресурсы являются подресурсами ресурса Customer , что отражает тот факт, что почти каждый вызов API должен быть нацелен на определенную учетную запись Search Ads 360. Например, кампании, группы объявлений, объявления и ключевые слова являются подресурсами корневого клиентского ресурса.
Объекты API отчетов Search Ads 360 (клиенты, кампании и т. д.) во всем API упоминаются по именам ресурсов. Однако важно отметить, что сами имена ресурсов могут иметь уникальные числовые идентификаторы ресурсов , которые идентифицируют каждый объект в иерархии. В этих случаях может быть полезно проанализировать имя ресурса, чтобы извлечь эти идентификаторы ресурсов и собрать новый.
Например, изучите имя ресурса AdGroupAd из предыдущей таблицы:
Его можно разбить на отдельные идентификаторы ресурсов (разделенные идентификаторами коллекций ) следующим образом:
Компоненты имени ресурса
Идентификаторы ресурсов
идентификатор клиента:
"1234567890"
Идентификатор группы объявлений:
"54321098765"
Идентификатор объявления группы объявлений:
"2109876543210"
Идентификаторы коллекций
"customers"
"adGroupAds"
Анализ отдельных идентификаторов позволяет получить новые имена ресурсов, которые будут ссылаться на клиента объявления группы объявлений ( customers/1234567890 ) или ее группу объявлений ( customers/1234567890/adGroupAds/54321098765 ).
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-09-25 UTC."],[],["The Search Ads 360 Reporting API uses a hierarchical structure for resource names, with most resources being sub-resources of the `Customer`. Each resource has a unique numerical ID within its resource name. Resource names are relative and can be parsed to extract these IDs. These IDs allow for the derivation of new resource names, referencing parent entities, like the customer or ad group. The `resourceName` field, not `name`, is used in JSON bodies.\n"]]