نام منابع

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

نام‌های منابع استفاده‌شده در Search Ads 360 Reporting API سلسله‌مراتبی هستند و سازمان نهادها را در 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

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

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

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

customers/1234567890/adGroupAds/54321098765~2109876543210

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

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

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