API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفتها و نسخههای آینده بهروز باشید.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
سلسله مراتب نام
نام منابع مورد استفاده در Search Ads 360 Reporting API سلسله مراتبی است و سازماندهی موجودیت ها را در Search Ads 360 منعکس می کند. تقریباً همه منابع منابع فرعی منبع Customer هستند که نشان دهنده این واقعیت است که تقریباً هر تماس API باید یک حساب جستجوی Ads 360 خاص را هدف قرار دهد. برای مثال، کمپینها، گروههای تبلیغاتی، تبلیغات و کلمات کلیدی همگی منابع فرعی یک منبع مشتری ریشه هستند.
Search Ads 360 Reporting API موجودیتها (مشتریان، کمپینها و غیره) با نام منابعشان در سراسر API ارجاع داده میشوند. با این حال، توجه به این نکته مهم است که نام منابع خود ممکن است دارای شناسه های عددی منحصر به فردی باشد که هر شیء را در سلسله مراتب شناسایی می کند. در این موارد، تجزیه نام منبع برای استخراج این شناسه های منبع و مونتاژ یک شناسه جدید ممکن است مفید باشد.
به عنوان مثال، نام منبع AdGroupAd را از جدول قبلی بررسی کنید:
این را می توان به شناسه های منبع فردی آن (که با شناسه های مجموعه از هم جدا شده اند) به شرح زیر تقسیم کرد:
اجزای نام منبع
شناسه های منابع
شناسه مشتری:
"1234567890"
شناسه گروه تبلیغات:
"54321098765"
شناسه آگهی گروه تبلیغات:
"2109876543210"
شناسه های مجموعه
"customers"
"adGroupAds"
تجزیه شناسههای فردی به شما امکان میدهد نامهای منابع جدیدی را برای ارجاع به مشتری آگهی گروه آگهی ( customers/1234567890 ) یا گروه تبلیغات آن ( customers/1234567890/adGroupAds/54321098765 ) استخراج کنید.
تاریخ آخرین بهروزرسانی 2025-09-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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 بهوقت ساعت هماهنگ جهانی."],[],["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"]]