- درخواست HTTP
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- فراداده محصول
- برنامه ریزی هدف گذاری
- YouTubeSelectLineUp
- ترکیبات سطح هدف
- آن را امتحان کنید!
فهرستی از قالبهای تبلیغات YouTube قابل برنامهریزی در هر مکان را با هدفیابی مجاز برمیگرداند.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QuotaError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v16:listPlannableProducts
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "plannableLocationId": string } |
زمینه های | |
---|---|
plannableLocationId | ضروری. شناسه محل انتخاب شده برای برنامه ریزی. برای فهرست کردن شناسههای مکان قابل برنامهریزی موجود، از |
بدن پاسخگو
پاسخی با تمام محصولات موجود
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"productMetadata": [
{
object ( |
زمینه های | |
---|---|
productMetadata[] | فهرست محصولات موجود برای برنامهریزی و فراداده هدفیابی مرتبط. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
فراداده محصول
فراداده مرتبط با یک محصول قابل برنامه ریزی در دسترس.
نمایندگی JSON |
---|
{
"plannableProductName": string,
"plannableTargeting": {
object ( |
زمینه های | |
---|---|
plannableProductName | نام مرتبط با محصول تبلیغاتی |
plannableTargeting | هدف گذاری مجاز قابل برنامه ریزی برای این محصول. |
plannableProductCode | کد مرتبط با محصول تبلیغاتی (به عنوان مثال: BUMPER، TRUEVIEW_IN_STREAM). برای فهرست کردن کدهای محصول قابل برنامه ریزی موجود، از |
برنامه ریزی هدف گذاری
هدف گذاری که معیارهای ترافیک برای آن گزارش می شود.
نمایندگی JSON |
---|
{ "ageRanges": [ enum ( |
زمینه های | |
---|---|
ageRanges[] | محدوده سنی قابل برنامه ریزی مجاز برای محصولی که سنجه ها برای آن گزارش می شود. هدف گذاری واقعی با نگاشت این محدوده سنی روی مقادیر استاندارد Google common.AgeRangeInfo محاسبه می شود. |
genders[] | جنسیت های قابل هدف برای محصول تبلیغاتی |
devices[] | دستگاه های قابل هدف برای محصول تبلیغاتی. هنگامی که هدفگیری MOBILE برای محصولات CPM_MASTHEAD، GOOGLE_PREFERRED_BUMPER، و GOOGLE_PREFERRED_SHORT انتخاب میشود، هدفگیری دستگاه TABLET بهطور خودکار برای معیارهای گزارششده اعمال میشود. |
networks[] | شبکه های قابل هدف برای محصول تبلیغاتی |
youtubeSelectLineups[] | لیستهای هدفمند YouTube را برای محصول تبلیغاتی انتخاب کنید. |
surfaceTargeting | ترکیب سطوح قابل هدف برای محصول تبلیغاتی. |
YouTubeSelectLineUp
یک لیست قابل برنامه ریزی انتخاب YouTube برای هدف گذاری محصول.
نمایندگی JSON |
---|
{ "lineupId": string, "lineupName": string } |
زمینه های | |
---|---|
lineupId | شناسه صف انتخاب YouTube. |
lineupName | نام منحصر به فرد مجموعه انتخاب YouTube. |
ترکیبات سطح هدف
ترکیبات سطح هدف گذاری موجود برای یک محصول تبلیغاتی.
نمایندگی JSON |
---|
{ "defaultTargeting": { object ( |
زمینه های | |
---|---|
defaultTargeting | هدفیابی سطح پیشفرض روی محصول تبلیغاتی اعمال میشود. |
availableTargetingCombinations[] | ترکیبات سطح هدف موجود برای محصول تبلیغاتی. |