- طلب HTTP
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ProductMetadata
- PlannableTargeting
- YouTubeSelectLineUp
- SurfaceTargetingCombinations
- جرِّبه الآن
تعرض قائمة أشكال الإعلانات على YouTube القابلة للتخطيط حسب الموقع الجغرافي مع الاستهداف المسموح به.
قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v15:listPlannableProducts
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "plannableLocationId": string } |
الحقول | |
---|---|
plannableLocationId |
مطلوبة. رقم تعريف الموقع الجغرافي المحدّد للتخطيط. لإدراج أرقام تعريف المواقع الجغرافية المتاحة للتخطيط، استخدِم |
نص الاستجابة
ردّ يتضمّن كلّ المنتجات المتوفّرة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"productMetadata": [
{
object ( |
الحقول | |
---|---|
productMetadata[] |
قائمة المنتجات المتاحة للتخطيط والبيانات الوصفية للاستهداف ذي الصلة. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
ProductMetadata
البيانات الوصفية المرتبطة بمنتج متوفّر قابل للتخطيط
تمثيل JSON |
---|
{
"plannableProductName": string,
"plannableTargeting": {
object ( |
الحقول | |
---|---|
plannableProductName |
الاسم المرتبط بالمنتج الإعلاني. |
plannableTargeting |
الاستهداف القابل للتخطيط المسموح به لهذا المنتج. |
plannableProductCode |
الرمز المرتبط بمنتج الإعلان (على سبيل المثال: BUMPER وTRUEVIEW_IN_STREAM). لإدراج رموز المنتجات المتاحة القابلة للتخطيط، استخدِم السمة |
PlannableTargeting
الاستهداف الذي سيتم إعداد تقارير مقاييس الزيارات له.
تمثيل JSON |
---|
{ "ageRanges": [ enum ( |
الحقول | |
---|---|
ageRanges[] |
الفئات العمرية المسموح بها القابلة للتخطيط للمنتج التي سيتم إعداد تقارير بالمقاييس الخاصة بها يتم احتساب الاستهداف الفعلي من خلال ربط هذه الفئة العمرية بقيم شائعة في Google تشمل فئات عمرية معيّنة (AgeRangeInfo). |
genders[] |
أجناس قابلة للاستهداف للمنتج الإعلاني. |
devices[] |
أجهزة قابلة للاستهداف من أجل المنتج الإعلاني يتمّ تطبيق استهداف أجهزة الأجهزة اللوحية تلقائيًا على المقاييس المبلّغ عنها عند اختيار استهداف الأجهزة الجوّالة للمنتجات CPM_MASTHEAD وGOOGLE_PREFERRED_BUMPER وGOOGLE_PREFERRED_SHORT. |
networks[] |
شبكات قابلة للاستهداف من أجل المنتج الإعلاني |
youtubeSelectLineups[] |
قوائم YouTube Select القابلة للاستهداف للمنتج الإعلاني |
surfaceTargeting |
مجموعات مساحات عرض قابلة للاستهداف لمنتج الإعلان |
YouTubeSelectLineUp
قائمة YouTube Select قابلة للتخطيط لاستهداف المنتجات.
تمثيل JSON |
---|
{ "lineupId": string, "lineupName": string } |
الحقول | |
---|---|
lineupId |
رقم تعريف قائمة YouTube Select |
lineupName |
الاسم الفريد لقائمة YouTube Select. |
SurfaceTargetingCombinations
مجموعات استهداف مساحات العرض المتوفّرة لمنتج إعلاني.
تمثيل JSON |
---|
{ "defaultTargeting": { object ( |
الحقول | |
---|---|
defaultTargeting |
تم تطبيق استهداف مساحة العرض التلقائي على المنتج الإعلاني. |
availableTargetingCombinations[] |
المجموعات الإعلانية المستهدفة المتاحة للمنتج الإعلاني |