فراداده منابع

می‌توانید از GoogleAdsFieldService برای درخواست پویا کاتالوگ برای منابع، فیلدهای منبع، کلیدهای بخش‌بندی و معیارهای موجود در روش‌های جستجوی GoogleAdsService و SearchStream استفاده کنید. این کاتالوگ ابرداده‌هایی را ارائه می‌کند که می‌توانند توسط مشتریان API Google Ads برای اعتبارسنجی و ساخت عبارات زبان جستجوی Google Ads استفاده شوند.

نمونه درخواست و پاسخ HTTP

این درخواست شامل یک HTTP GET به سرور Google Ads API در URL زیر است:

https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}

نمونه زیر نمونه ای از درخواستی است که به دنبال آن پاسخی است که از GoogleAdsFieldService برای منبع ad_group برگردانده شده است:

درخواست کنید

https://googleads.googleapis.com/v17/googleAdsFields/ad_group

پاسخ

{
  "resourceName": "googleAdsFields/ad_group",
  "name": "ad_group",
  "category": "RESOURCE",
  "selectable": false,
  "filterable": false,
  "sortable": false,
  "selectableWith": [
    "campaign",
    "customer",
    "metrics.average_cpc",
    "segments.device",
    ...
  ],
  "attributeResources": [
    "customer",
    "campaign"
  ],

  "metrics": [
    "metrics.conversions",
    "metrics.search_budget_lost_impression_share",
    "metrics.average_cost",
    "metrics.clicks",
    ...
  ],
  "segments": [
    "segments.date",
    "segments.ad_network_type",
    "segments.device",
    ...
  ]
}

برای این مثال، آرایه های مهم عبارتند از:

attributeResources
منابعی که می توانند به طور ضمنی به منبع در عبارت FROM ملحق شوند.
metrics
معیارهایی که برای انتخاب با منبع موجود در عبارت FROM در دسترس هستند. فقط برای فیلدهایی پر شده است که category آن RESOURCE است.
segments
کلیدهای بخش که می توانند با منبع موجود در عبارت FROM انتخاب شوند. این معیارهای مشخص شده در پرس و جو را تقسیم بندی می کنند. فقط برای فیلدهایی پر شده است که category آن RESOURCE است.
selectableWith
فیلدهایی که می توانند در کنار یک فیلد مشخص انتخاب شوند، در صورتی که در عبارت FROM نباشند. این ویژگی تنها زمانی مرتبط است که منابع یا بخش‌هایی را که می‌توان در یک جستار انتخاب کرد، در جایی که منبع در عبارت FROM درج نمی‌کند، مرتبط است. به عنوان مثال، اگر ad_group.id و segments.date را از ad_group انتخاب می‌کنیم، و می‌خواهیم ویژگی‌هایی را از campaign اضافه کنیم، باید بررسی کنیم که segments.date در ویژگی selectableWith برای کمپین باشد، زیرا در کنار علامت انتخاب می‌شود. segments.date موجود. فیلد تاریخ.

جزئیات فراداده

می توانید کاتالوگ را با استفاده از GoogleAdsFieldService در این سطوح درخواست کنید:

منبع
به عنوان مثال، googleAdsFields/campaign .
زمینه منابع
به عنوان مثال، googleAdsFields/campaign.name .
زمینه تقسیم بندی
به عنوان مثال، googleAdsFields/segments.ad_network_type .
متریک
به عنوان مثال، googleAdsFields/metrics.clicks .