Method: listPlannableProducts

فهرستی از قالب‌های تبلیغات YouTube قابل برنامه‌ریزی در هر مکان را با هدف‌یابی مجاز برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QuotaError RequestError

درخواست HTTP

POST https://googleads.googleapis.com/v15:listPlannableProducts

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "plannableLocationId": string
}
زمینه های
plannableLocationId

string

ضروری. شناسه محل انتخاب شده برای برنامه ریزی. برای فهرست کردن شناسه‌های مکان قابل برنامه‌ریزی موجود، از ReachPlanService.ListPlannableLocations استفاده کنید.

بدن پاسخگو

پاسخی با تمام محصولات موجود

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
زمینه های
productMetadata[]

object ( ProductMetadata )

فهرست محصولات موجود برای برنامه‌ریزی و فراداده هدف‌یابی مرتبط.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/adwords

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

فراداده محصول

فراداده مرتبط با یک محصول قابل برنامه ریزی در دسترس.

نمایندگی JSON
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
زمینه های
plannableProductName

string

نام مرتبط با محصول تبلیغاتی

plannableTargeting

object ( PlannableTargeting )

هدف گذاری مجاز قابل برنامه ریزی برای این محصول.

plannableProductCode

string

کد مرتبط با محصول تبلیغاتی (به عنوان مثال: BUMPER، TRUEVIEW_IN_STREAM). برای فهرست کردن کدهای محصول قابل برنامه ریزی موجود، از ReachPlanService.ListPlannableProducts استفاده کنید.

برنامه ریزی هدف گذاری

هدف گذاری که معیارهای ترافیک برای آن گزارش می شود.

نمایندگی JSON
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
زمینه های
ageRanges[]

enum ( ReachPlanAgeRange )

محدوده سنی قابل برنامه ریزی مجاز برای محصولی که سنجه ها برای آن گزارش می شود. هدف گذاری واقعی با نگاشت این محدوده سنی روی مقادیر استاندارد Google common.AgeRangeInfo محاسبه می شود.

genders[]

object ( GenderInfo )

جنسیت های قابل هدف برای محصول تبلیغاتی

devices[]

object ( DeviceInfo )

دستگاه های قابل هدف برای محصول تبلیغاتی. هنگامی که هدف‌گیری MOBILE برای محصولات CPM_MASTHEAD، GOOGLE_PREFERRED_BUMPER، و GOOGLE_PREFERRED_SHORT انتخاب می‌شود، هدف‌گیری دستگاه TABLET به‌طور خودکار برای معیارهای گزارش‌شده اعمال می‌شود.

networks[]

enum ( ReachPlanNetwork )

شبکه های قابل هدف برای محصول تبلیغاتی

youtubeSelectLineups[]

object ( YouTubeSelectLineUp )

لیست‌های هدفمند YouTube را برای محصول تبلیغاتی انتخاب کنید.

surfaceTargeting

object ( SurfaceTargetingCombinations )

ترکیب سطوح قابل هدف برای محصول تبلیغاتی.

YouTubeSelectLineUp

یک لیست قابل برنامه ریزی انتخاب YouTube برای هدف گذاری محصول.

نمایندگی JSON
{
  "lineupId": string,
  "lineupName": string
}
زمینه های
lineupId

string ( int64 format)

شناسه صف انتخاب YouTube.

lineupName

string

نام منحصر به فرد مجموعه انتخاب YouTube.

ترکیبات سطح هدف

ترکیبات سطح هدف گذاری موجود برای یک محصول تبلیغاتی.

نمایندگی JSON
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
زمینه های
defaultTargeting

object ( SurfaceTargeting )

هدف‌یابی سطح پیش‌فرض روی محصول تبلیغاتی اعمال می‌شود.

availableTargetingCombinations[]

object ( SurfaceTargeting )

ترکیبات سطح هدف موجود برای محصول تبلیغاتی.