REST Resource: advertisers.lineItems

المرجع: عنصر

عنصر واحد.

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}
الحقول
name

string

النتائج فقط. اسم المورد للعنصر.
advertiserId

string (int64 format)

النتائج فقط. المعرّف الفريد للمعلِن الذي ينتمي إليه العنصر.
campaignId

string (int64 format)

النتائج فقط. رقم التعريف الفريد للحملة التي ينتمي إليها العنصر.
insertionOrderId

string (int64 format)

مطلوبة. غير قابل للتغيير. المعرّف الفريد لطلب الإدراج الذي ينتمي إليه العنصر.
lineItemId

string (int64 format)

النتائج فقط. المعرّف الفريد للعنصر. تم تعيينه من قِبل النظام.
displayName

string

مطلوبة. الاسم المعروض للعنصر.

يجب ترميزها باستخدام UTF-8 بحيث يبلغ الحد الأقصى للحجم 240 بايت.
lineItemType

enum (LineItemType)

مطلوبة. غير قابل للتغيير. تمثّل هذه السمة نوع العنصر.
entityStatus

enum (EntityStatus)

مطلوبة. تتحكّم هذه السياسة في ما إذا كان بإمكان العنصر إنفاق ميزانيتها وتقديم عرض سعر لها على المستودع أم لا.

  • بالنسبة إلى طريقة lineItems.create، يُسمح فقط باستخدام ENTITY_STATUS_DRAFT. لتفعيل عنصر، استخدِم طريقة lineItems.patch وعدِّل الحالة إلى ENTITY_STATUS_ACTIVE بعد الإنشاء.
  • لا يمكن إعادة العنصر إلى حالة ENTITY_STATUS_DRAFT من أي حالة أخرى.
  • إذا لم يكن طلب الإدراج الرئيسي للعنصر نشطًا، لن يتمكّن من إنفاق ميزانيته حتى إذا كانت حالته هي ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر تعديل للعنصر. تم تعيينه من قِبل النظام.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
partnerCosts[]

object (PartnerCost)

تكاليف الشريك المرتبطة بالبند.

في حال عدم توفّر هذه التفاصيل أو تركها فارغة في طريقة lineItems.create، سيكتسب العنصر الذي تم إنشاؤه حديثًا تكاليف الشريك من طلب الإدراج الرئيسي.
flight

object (LineItemFlight)

مطلوبة. وقت البدء والانتهاء لرحلة عرض العنصر.
budget

object (LineItemBudget)

مطلوبة. إعداد تخصيص الميزانية للعنصر.
pacing

object (Pacing)

مطلوبة. إعداد سرعة إنفاق الميزانية للعنصر.
frequencyCap

object (FrequencyCap)

مطلوبة. إعدادات تحديد عدد مرات الظهور للعنصر.

ويجب استخدام الحقل maxImpressions في كائن الإعدادات هذا في حال تحديد حد أقصى محدود.
partnerRevenueModel

object (PartnerRevenueModel)

مطلوبة. إعداد نموذج أرباح الشريك للعنصر.
conversionCounting

object (ConversionCountingConfig)

إعداد تتبُّع الإحالات الناجحة للعنصر.
creativeIds[]

string (int64 format)

أرقام تعريف تصاميم الإعلانات المرتبطة بالعنصر.
bidStrategy

object (BiddingStrategy)

مطلوبة. استراتيجية عروض الأسعار للعنصر.
integrationDetails

object (IntegrationDetails)

تفاصيل دمج العنصر.
inventorySourceIds[]

string (int64 format)

أرقام تعريف مصادر المستودع الخاصة المخصّصة للعنصر.
targetingExpansion

object (TargetingExpansionConfig)

إعدادات توسيع الاستهداف للعنصر.

لا يسري هذا الإعداد إلّا عند تخصيص استهداف قائمة مستخدِمين مؤهَّل للعنصر.
warningMessages[]

enum (LineItemWarningMessage)

النتائج فقط. رسائل التحذير التي تم إنشاؤها بواسطة العنصر. لا تحظر هذه التحذيرات حفظ العنصر، ولكن قد يؤدي بعضها إلى منع عرض العنصر.
mobileApp

object (MobileApp)

التطبيق المتوافق مع الأجهزة الجوّالة الذي يتم الترويج له من خلال العنصر.

ولا ينطبق هذا الإجراء إلا إذا كانت قيمة السمة lineItemType هي LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL أو LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

النتائج فقط. تمثّل هذه السمة نوع حجز العنصر.
excludeNewExchanges

boolean

ما إذا كان سيتم استبعاد التبادلات الجديدة من الاستهداف التلقائي بواسطة العنصر. يكون هذا الحقل على "خطأ" تلقائيًا.

LineItemType

الأنواع المحتملة من العنصر.

يحدِّد نوع العنصر الإعدادات والخيارات السارية، مثل شكل الإعلانات أو خيارات الاستهداف.

عمليات التعداد
LINE_ITEM_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو أنها غير معروفة في هذا الإصدار.
LINE_ITEM_TYPE_DISPLAY_DEFAULT الإعلانات المصوّرة أو إعلانات HTML5 أو الإعلانات المدمجة مع المحتوى أو إعلانات الوسائط الغنية.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL عرض الإعلانات التي تزيد عمليات تثبيت التطبيق
LINE_ITEM_TYPE_VIDEO_DEFAULT إعلانات الفيديو التي يتم بيعها على أساس التكلفة لكل ألف ظهور في مجموعة متنوعة من البيئات.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL إعلانات الفيديو التي تزيد من عمليات تثبيت أحد التطبيقات
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY الإعلانات الصورية المعروضة على مستودع التطبيقات المتوافقة مع الأجهزة الجوّالة.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY إعلانات الفيديو المعروضة على مستودع التطبيقات المتوافقة مع الأجهزة الجوّالة.
LINE_ITEM_TYPE_AUDIO_DEFAULT تُباع الإعلانات الصوتية المستندة إلى عرض الأسعار في الوقت الفعلي (RTB) لمجموعة متنوعة من البيئات.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP تتوفّر إعلانات خدمة البث المباشر على الإنترنت في طلبات إدراج خدمة البث المباشر على الإنترنت. لا ينطبق هذا النوع إلا على العناصر التي لها طلب إدراج بقيمة insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_DISPLAY_COMMERCE إعلانات المنتجات الدعائية التي يتم عرضها على موقع بائع التجزئة.

LineItemFlight

الإعدادات التي تتحكّم في المدة النشطة لعنصر معيّن.

تمثيل JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}
الحقول
flightDateType

enum (LineItemFlightDateType)

مطلوبة. تمثّل هذه السمة نوع تواريخ عرض تفاصيل الإعلان.
dateRange

object (DateRange)

تاريخا بدء عرض الإعلانات وانتهائها للعنصر. ويتم حلها وفقًا للمنطقة الزمنية للمعلِن الرئيسي.

  • يجب ملء هذا الحقل عندما تكون قيمة الحقل "flightDateType" هي "LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM". إخراج البيانات فقط في الحالات الأخرى
  • عند إنشاء رحلة جديدة، يجب أن يكون كلّ من startDate وendDate في المستقبل.
  • تتضمّن الرحلة الجوية الحالية التي تحمل startDate في الماضي عنصر endDate قابل للتغيير، بينما يتضمّن startDate غير قابل للتغيير.
  • يجب أن تكون القيمة endDate هي startDate أو تاريخ لاحق، وكلاهما قبل عام 2037.
triggerId

string (int64 format)

رقم تعريف المشغِّل اليدوي المرتبط بالعنصر.

  • يجب ملء هذا الحقل عندما تكون قيمة الحقل "flightDateType" هي "LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER". ويجب عدم ضبطها بطريقة أخرى.
  • عند الضبط، يتم اكتساب تواريخ إطلاق العنصر من طلب الإدراج الرئيسي.
  • سيتم إنفاق العناصر النشطة عند تفعيل العامل المشغِّل المحدّد خلال تواريخ إطلاق طلب الإدراج الرئيسي.

LineItemFlightDateType

الأنواع المحتملة لتواريخ عرض تفاصيل الإعلان.

عمليات التعداد
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو أنها غير معروفة في هذا الإصدار.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED يتم اكتساب تواريخ إطلاق العنصر من طلب الإدراج الرئيسي.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM يستخدِم العنصر تواريخ عرض الإعلانات المخصّصة له.
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER يستخدِم العنصر مشغّلاً.

LineItemBudget

الإعدادات التي تتحكّم في كيفية تخصيص الميزانية

تمثيل JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
الحقول
budgetAllocationType

enum (LineItemBudgetAllocationType)

مطلوبة. نوع توزيع الميزانية.

لا يسري LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC إلا عند تفعيل التخصيص التلقائي للميزانية لطلب الإدراج الرئيسي.
budgetUnit

enum (BudgetUnit)

النتائج فقط. تحدد وحدة الميزانية ما إذا كانت الميزانية تعتمد على العملة أو مستندة إلى مرات الظهور. هذه القيمة مكتسَبة من طلب الإدراج الرئيسي.
maxAmount

string (int64 format)

الحد الأقصى لمبلغ الميزانية الذي سينفقه العنصر. يجب أن يكون أكبر من 0.

عندما تكون قيمة الحقل "budgetAllocationType":

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC، هذا الحقل غير قابل للتغيير ويتم ضبطه من خلال النظام.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED، إذا كان budgetUnit:
    • BUDGET_UNIT_CURRENCY، يمثل هذا الحقل الحد الأقصى لمبلغ الميزانية المراد إنفاقه بوحدات المايكرو من عملة المعلِن. على سبيل المثال، 1500000 يمثل 1.5 وحدة قياسية من العملة.
    • BUDGET_UNIT_IMPRESSIONS، يمثل هذا الحقل الحد الأقصى لعدد مرات الظهور المطلوب عرضها.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED، هذا الحقل غير سارٍ وسيتجاهله النظام.

LineItemBudgetAllocationType

الأنواع المحتملة من توزيع الميزانية

عمليات التعداد
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو أنها غير معروفة في هذا الإصدار.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC تم تفعيل التخصيص التلقائي للميزانية للعنصر.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED يتم تخصيص مبلغ أقصى ثابت للميزانية للعنصر.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED لا يتم تطبيق حدّ ميزانية على العنصر.

PartnerRevenueModel

الإعدادات التي تتحكّم في كيفية احتساب أرباح الشريك

تمثيل JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
الحقول
markupType

enum (PartnerRevenueModelMarkupType)

مطلوبة. نوع الترميز لنموذج أرباح الشريك.
markupAmount

string (int64 format)

مطلوبة. مبلغ الترميز الخاص بنموذج أرباح الشريك. يجب أن تكون أكبر من أو تساوي 0.

  • عند ضبط القيمة markupType على PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM، يمثّل هذا الحقل ترميز التكلفة لكل ألف ظهور بالمايكرو من عملة المعلِن. على سبيل المثال، 1500000 يمثل 1.5 وحدة قياسية من العملة.
  • عند ضبط markupType على PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP، يمثّل هذا الحقل ترميز النسبة المئوية لتكلفة جميع الوسائل بالمللي ثانية. على سبيل المثال، 100 تمثل 0.1% (رقم عشري 0.001).
  • عند ضبط قيمة markupType على PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP، يمثّل هذا الحقل ترميز النسبة المئوية لإجمالي تكلفة جميع الوسائل بالمللي ثانية. على سبيل المثال، 100 تمثل 0.1% (رقم عشري 0.001).

PartnerRevenueModelMarkupType

أنواع الترميز المحتملة لنموذج أرباح الشركاء.

عمليات التعداد
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو أنها غير معروفة في هذا الإصدار.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM احتساب أرباح الشريك استنادًا إلى تكلفة ثابتة لكل ألف ظهور
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

احتساب أرباح الشريك استنادًا إلى نسبة مئوية إضافية من تكلفة جميع الوسائل
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP احتساب أرباح الشريك استنادًا إلى نسبة مئوية إضافية من إجمالي تكلفة وسائل الإعلام، والتي تشمل جميع تكاليف الشركاء وتكاليف البيانات

ConversionCountingConfig

الإعدادات التي تتحكّم في كيفية احتساب الإحالات الناجحة.

سيتم احتساب جميع الإحالات الناجحة بعد النقر. ويمكن ضبط قيمة للنسبة المئوية لاحتساب الإحالات الناجحة بعد المشاهدة.

تمثيل JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
الحقول
postViewCountPercentageMillis

string (int64 format)

النسبة المئوية للإحالات الناجحة بعد المشاهدة المطلوب احتسابها بالمللي ثانية (1/1000 من النسبة المئوية). يجب أن تتراوح القيمة بين 0 و100000 ضمنًا.

على سبيل المثال، لتتبُّع 50% من الإحالات الناجحة بعد النقر، اضبط القيمة 50,000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

إعدادات نشاط Floodlight المستخدَمة لتتبُّع الإحالات الناجحة.

عدد الإحالات الناجحة التي يتم احتسابها هو مجموع كل الإحالات الناجحة التي تم احتسابها من خلال جميع أرقام تعريف نشاط Floodlight المحدّدة في هذا الحقل.

TrackingFloodlightActivityConfig

الإعدادات التي تتحكّم في سلوك عملية ضبط واحدة لنشاط Floodlight.

تمثيل JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
الحقول
floodlightActivityId

string (int64 format)

مطلوبة. رقم تعريف نشاط Floodlight.
postClickLookbackWindowDays

integer

مطلوبة. عدد الأيام التي تلي النقر على الإعلان والتي قد يتمّ احتساب الإحالة الناجحة فيها. يجب أن تتراوح القيمة بين 0 و90 ضمنًا.
postViewLookbackWindowDays

integer

مطلوبة. عدد الأيام التي تلي مشاهدة الإعلان والتي يتم احتساب الإحالة الناجحة فيها. يجب أن تتراوح القيمة بين 0 و90 ضمنًا.

TargetingExpansionConfig

الإعدادات التي تتحكّم في توسيع استهداف العنصر. تسمح ميزة "توسيع نطاق الاستهداف" للعنصر بالوصول إلى شريحة أكبر من الجمهور استنادًا إلى قائمة المستخدمين الأصلية ومستوى توسيع نطاق الاستهداف.

تمثيل JSON 
{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}
الحقول
targetingExpansionLevel

enum (TargetingExpansionLevel)

مطلوبة. حجم التوسيع للاستهداف الساري ضمن هذا البند.
excludeFirstPartyAudience

boolean

مطلوبة. ما إذا كان سيتم استبعاد شرائح جمهور الطرف الأول من الاستهداف.

لن يتم استبعاد الجمهور المشابه لقوائم الطرف الأول المستبعدة. ينطبق فقط عند استهداف جمهور الطرف الأول بشكل إيجابي (بشكل مباشر أو مضمّن في جمهور مُجمَّع)، وإلّا فسيتم تجاهل هذا الاختيار.

TargetingExpansionLevel

الوصف النوعي لمستوى التوسيع.

عمليات التعداد
TARGETING_EXPANSION_LEVEL_UNSPECIFIED مستوى توسيع الاستهداف غير محدد أو غير معروف في هذا الإصدار.
NO_EXPANSION توسيع الاستهداف غير مفعّل.
LEAST_EXPANSION توسيع نطاق الاستهداف المحافظ، وأقل مدى وصول إلى الجمهور.
SOME_EXPANSION توسيع نطاق استهداف معتدل نوعًا ما، مع انخفاض مدى الوصول إلى الجمهور.
BALANCED_EXPANSION توسيع نطاق الاستهداف المعتدل، ومدى وصول متوسط.
MORE_EXPANSION توسيع استهداف قوي نوعًا ما، ومدى وصول أعلى.
MOST_EXPANSION توسيع نطاق الاستهداف القوي، وأعلى مدى وصول.

LineItemWarningMessage

رسائل التحذير التي يتم إنشاؤها بواسطة أحد العناصر. لا تحظر هذه الأنواع من التحذيرات حفظ عنصر، ولكنّها قد تمنع عرض عنصر.

عمليات التعداد
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED غير محدّد أو غير معروف.
INVALID_FLIGHT_DATES يحتوي هذا العنصر على تواريخ عرض إعلانات غير صالحة. ولن يتمّ تشغيل العنصر.
EXPIRED يقع تاريخ انتهاء هذا العنصر في الماضي.
PENDING_FLIGHT سيبدأ تنفيذ هذا العنصر في المستقبل.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED جميع التبادلات المفعّلة للشركاء مستهدَفة سلبًا. ولن يتمّ تشغيل العنصر.
INVALID_INVENTORY_SOURCE لا يجري استهداف أي مصادر مستودع نشطة. ولن يتمّ تشغيل العنصر.
APP_INVENTORY_INVALID_SITE_TARGETING لا يتضمّن استهداف التطبيقات وعناوين URL لهذا العنصر أيّ تطبيقات متوافقة مع الأجهزة الجوّالة. يتطلب نوع هذا العنصر تضمين التطبيقات المتوافقة مع الأجهزة الجوّالة في استهداف القناة أو قائمة المواقع الإلكترونية أو التطبيقات. ولن يتمّ تشغيل العنصر.
APP_INVENTORY_INVALID_AUDIENCE_LISTS لا يستهدف هذا العنصر أي مستخدم للأجهزة الجوّالة. يتطلب نوع هذا العنصر أن تستهدف قائمة مستخدمين بمستخدمي الأجهزة الجوّالة. ولن يتمّ تشغيل العنصر.
NO_VALID_CREATIVE لا يحتوي هذا العنصر على أي تصميم إعلان صالح. ولن يتمّ تشغيل العنصر.
PARENT_INSERTION_ORDER_PAUSED طلب الإدراج لهذا العنصر متوقف مؤقتًا. ولن يتمّ تشغيل العنصر.
PARENT_INSERTION_ORDER_EXPIRED تم تحديد تاريخ انتهاء طلب الإدراج لهذا العنصر في الماضي. ولن يتمّ تشغيل العنصر.
NO_POSITIVE_AUDIENCE_LIST_TARGETED لا يستهدف هذا العنصر أي قوائم مستخدمين، ما قد يؤدي إلى إنفاق ميزانيتك بسرعة أكبر من اللازم.
APP_INSTALL_NO_CONVERSION_PIXEL لا يحتوي عنصر تثبيت التطبيق هذا على أيّ وحدة بكسل تم إعدادها للإحالة الناجحة.
TARGETING_REVOKED_OR_CLOSED_USER_LIST يستهدف هذا العنصر قائمة مستخدمين واحدة أو أكثر لم تعُد متوفّرة. وفي المستقبل، سيؤدي ذلك إلى منع عرض العنصر، لذا ننصحك بإزالة هذه القوائم من الاستهداف.
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY لا يحتوي عنصر تثبيت التطبيق هذا على استراتيجية عروض أسعار مثلى.
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS الصفقات التي يستهدفها هذا العنصر تقبل أحجام تصميمات الإعلانات التي لا تكون قيد الاستخدام. وقد يحدّ ذلك من عرض العنصر أو مستوى أدائه.
NO_CREATIVE_FOR_TARGETED_DEALS لا يحتوي هذا العنصر على أي تصميم إعلان للصفقات المستهدَفة.
TARGETING_DEPRECATED_GEO_TARGET يستهدف هذا العنصر استهدافًا جغرافيًا تم إيقافه.

MobileApp

تطبيق متوافق مع الأجهزة الجوّالة يتم الترويج له من خلال عنصر تثبيت تطبيق متوافق مع الأجهزة الجوّالة.

تمثيل JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
الحقول
appId

string

مطلوبة. رقم تعريف التطبيق الذي وفّره متجر المنصّة

يتم التعرّف على تطبيقات Android من خلال معرّف الحزمة الذي يستخدمه "متجر Play" على أجهزة Android، مثل com.google.android.gm.

يتم التعرّف على تطبيقات iOS من خلال رقم تعريف تطبيق مكوَّن من تسعة أرقام يستخدمه متجر App Store من Apple، مثل 422689480.
platform

enum (Platform)

النتائج فقط. النظام الأساسي للتطبيق.
displayName

string

النتائج فقط. اسم التطبيق
publisher

string

النتائج فقط. ناشر التطبيق.

النظام الأساسي

الأنظمة الأساسية المحتملة للتطبيقات المتوافقة مع الأجهزة الجوّالة.

عمليات التعداد
PLATFORM_UNSPECIFIED لم يتم تحديد النظام الأساسي.
IOS نظام التشغيل iOS.
ANDROID نظام Android الأساسي.

الطُرق

bulkEditLineItemAssignedTargetingOptions

 التعديلات المجمّعة لخيارات الاستهداف ضمن بند واحد.

bulkListLineItemAssignedTargetingOptions

 يسرد خيارات الاستهداف المعينة لعنصر على مستوى أنواع الاستهداف.

create

 تُنشئ عنصرًا جديدًا.

delete

 حذف عنصر

generateDefault

 إنشاء عنصر جديد مع إعدادات (بما في ذلك الاستهداف) المكتسبة من طلب الإدراج وENTITY_STATUS_DRAFT entity_status.

get

 الحصول على عنصر.

list

 يسرد العناصر في أحد المعلنين.

patch

 لتعديل عنصر حالي