نام منابع

سلسله مراتب نام

نام‌های منبع استفاده‌شده در «میانای برنامه‌سازی کاربردی گزارش‌دهی Search Ads 360» سلسله‌مراتبی هستند و سازمان نهادها را در Search Ads 360 منعکس می‌کنند. تقریباً همه منابع زیرمنبع منبع Customer هستند، که این واقعیت را منعکس می‌کند که تقریباً هر فراخوانی API باید یک حساب Search Ads 360 خاص را هدف قرار دهد. برای مثال، پویش‌ها، گروه‌های آگهی، آگهی‌ها، و کلیدواژه‌ها همه منابع فرعی منبع مشتری ریشه هستند.

منبع نام منبع
مشتری customers/1234567890
پویش customers/1234567890/campaigns/8765432109
AdGroup customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

شناسه‌های منبع

موجودیت‌های Search Ads 360 Reporting API (مشتریان، پویش‌ها، و غیره) در سراسر API با نام‌های منبعشان ارجاع داده می‌شوند. بااین‌حال، توجه به این نکته مهم است که نام‌های منبع خودشان ممکن است شناسه‌های منبع عددی منحصربه‌فردی داشته باشند که هر شیء را در سلسله‌مراتب شناسایی می‌کنند. در این موارد، تجزیه کردن نام منبع برای استخراج این شناسه‌های منبع و ایجاد شناسه جدید می‌تواند مفید باشد.

برای مثال، نام منبع AdGroupAd را از جدول قبلی بررسی کنید:

customers/1234567890/adGroupAds/54321098765~2109876543210

این را می‌توان به شناسه‌های منبع جداگانه آن (که با شناسه‌های مجموعه از هم جدا شده‌اند) به‌صورت زیر تقسیم کرد:

مؤلفه‌های نام منبع
شناسه‌های منبع
شناسه مشتری:
"1234567890"
شناسه گروه آگهی:
"54321098765"
شناسه آگهی گروه آگهی:
"2109876543210"
شناسه‌های مجموعه
"customers"
"adGroupAds"

تجزیه شناسه‌های فردی به شما امکان می‌دهد نام‌های منبع جدیدی را برای ارجاع به مشتری آگهی گروه آگهی (customers/1234567890) یا گروه آگهی آن (customers/1234567890/adGroupAds/54321098765) استخراج کنید.