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