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

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

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

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

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

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

درخواست 

https://googleads.googleapis.com/v22/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 برای campaign وجود داشته باشد، زیرا در کنار فیلد segments.date موجود انتخاب می‌شود.

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

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

منبع
برای مثال، googleAdsFields/campaign .
فیلد منبع
برای مثال، googleAdsFields/campaign.name .
فیلد تقسیم‌بندی
برای مثال، googleAdsFields/segments.ad_network_type .
متریک
برای مثال، googleAdsFields/metrics.clicks .
قبلی
بازیابی اشیاء
بعدی
ساختار تماس