احتیاط: شما در حال مشاهده اسناد رابط REST API هستید. اکثر کتابخانه های مشتری رسمی ما از gRPC استفاده می کنند. برای جزئیات بیشتر به مقدمه REST مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

نام منابع

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

نام منابع مورد استفاده در 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`

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

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

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

customers/1234567890/adGroupAds/54321098765~2109876543210

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

اجزای نام منبع

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

شناسه مشتری:	`"1234567890"`
شناسه گروه تبلیغات:	`"54321098765"`
شناسه آگهی گروه تبلیغات:	`"2109876543210"`

شناسه های مجموعه

"customers"

"adGroupAds"

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

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

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

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

مثال: اقدامات تبدیل بین حساب

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

نموداری که رابطه نام منابع را با سلسله مراتب حساب ها نشان می دهد.

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

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

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