نام منابع

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

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

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

نکته کلیدی: Google Ads API از نام‌های منبع نسبی (و نه نام‌های منبع کامل مانند برخی‌از میاناهای برنامه‌سازی کاربردی دیگر Google) استفاده می‌کند.

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

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

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

customers/1234567890/adGroupAds/54321098765~2109876543210

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

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

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

نکته کلیدی: نام‌های منبع در بدنه درخواست و پاسخ JSON با فیلد resourceName ارجاع داده می‌شوند، نه فیلد name مانند برخی دیگر از میاناهای برنامه‌سازی کاربردی Google Cloud. بسیاری از نهادهای Google Ads خودشان دارای مشخصه‌های نام هستند (campaign.Name، adGroup.Name، و غیره)، بنابراین از resourceName برای جلوگیری از تداخل با نام‌های شیء موجود استفاده می‌شود.

شناسه‌های اشیای مشترک

اکثر اشیاء در API با یک مشتری خاص Google Ads مرتبط هستند. بااین‌حال، برخی‌از انواع هدف وجود دارد که می‌توانند بین چندین حساب هم‌رسانی شوند. در عمل، این موارد چیزهایی مثل فهرست‌های کلیدواژه منفی یا کنش‌های تبدیل بین‌حسابی است که معمولاً توسط مدیران ایجاد می‌شوند و سپس با بسیاری از حساب‌های مشتری هم‌رسانی می‌شوند.

نام‌های منبع این نوع اشیا بسته به اینکه تماس API را به کدام حساب ارسال می‌کنید متفاوت خواهد بود.

مثال: کنش‌های تبدیل میان‌حسابی

فرض کنید حساب مدیری 987-654-3210 داریم که کنش تبدیلی بین‌حسابی را با یکی از حساب‌های مشتری 123-456-7890 خود هم‌رسانی می‌کند:

برقراری تماس API با حساب مدیر برای مثال، به‌روزرسانی پنجره بازگشتی کنش تبدیل، بااستفاده از نام منبع به شیء هم‌رسانی‌شده ارجاع می‌دهد: customers/9876543210/conversionActions/257733534.

برقراری تماس میانای برنامه‌سازی کاربردی با حساب مشتری برای موافقت با استفاده از کنش تبدیل مشترک، بااستفاده از نام منبع زیر به آن ارجاع می‌دهد: customers/1234567890/conversionActions/257733534.

این همان کنش تبدیل زیربنایی است، اما نام منبع آن نسبت به حسابی که برای دسترسی به آن استفاده می‌شود، نسبی است.