REST Resource: customBiddingAlgorithms

المرجع: خوارزمية CustomBidAlgorithm

خوارزمية عروض أسعار مخصّصة واحدة

تمثيل JSON 
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelReadiness": [
    {
      object (CustomBiddingModelReadinessState)
    }
  ],
  "customBiddingAlgorithmState": enum (State),

  // Union field owner can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field owner.
}
الحقول
name

string

النتائج فقط. اسم مورد خوارزمية عروض الأسعار المخصّصة
customBiddingAlgorithmId

string (int64 format)

النتائج فقط. المعرّف الفريد لخوارزمية عروض الأسعار المخصّصة. يحدده النظام.
displayName

string

مطلوب. الاسم المعروض لخوارزمية عروض الأسعار المخصّصة

يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 240 بايت.
entityStatus

enum (EntityStatus)

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

القيم المقبولة هي:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum (CustomBiddingAlgorithmType)

مطلوب. غير قابل للتغيير. نوع خوارزمية عروض الأسعار المخصّصة.
sharedAdvertiserIds[]

string (int64 format)

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

لن يتم ضبط هذا الحقل إذا كانت الخوارزمية owner شريكًا ويتم استردادها باستخدام معلِن accessor.
modelReadiness[]

object (CustomBiddingModelReadinessState)

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

لا يمكن أن يتضمّن هذا الحقل حالة المعلِن الذي أدخل طلب بحث إلّا إذا كانت الخوارزمية owner شريكًا ويتم استردادها باستخدام معلِن accessor.
customBiddingAlgorithmState

enum (State)

النتائج فقط. حالة خوارزمية عروض الأسعار المخصّصة
حقل الاتحاد owner. يتم تحديد جهة "مساحة العرض والفيديو 360" التي تملك خوارزمية عروض الأسعار المخصّصة. يمكن أن يكون شريكًا أو معلِنًا. يمكن أن يكون owner واحدًا فقط مما يلي:
partnerId

string (int64 format)

غير قابل للتغيير. المعرّف الفريد للشريك الذي يملك خوارزمية عروض الأسعار المخصّصة
advertiserId

string (int64 format)

غير قابل للتغيير. المعرّف الفريد للمعلِن الذي يملك خوارزمية عروض الأسعار المخصّصة

CustomBiddingAlgorithmType

الأنواع المحتملة من خوارزميات عروض الأسعار المخصّصة

عمليات التعداد
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED نوع الخوارزمية غير محدّد أو غير معروف في هذا الإصدار.
SCRIPT_BASED خوارزمية تم إنشاؤها من خلال ملفات النصوص البرمجية لعروض الأسعار المخصّصة التي حمّلها العميل.
ADS_DATA_HUB_BASED خوارزمية تم إنشاؤها من خلال منتج Ads Data Hub
GOAL_BUILDER_BASED خوارزمية تم إنشاؤها من خلال أداة إنشاء الأهداف في واجهة مستخدم "مساحة العرض والفيديو 360".

CustomBiddingModelReadinessState

حالة جاهزية نموذج خوارزمية عروض الأسعار المخصّصة لمعلِن واحد مشترك.

تمثيل JSON 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState)
}
الحقول
advertiserId

string (int64 format)

المعرّف الفريد للمعلِن المعنيّ.
readinessState

enum (ReadinessState)

حالة جاهزية نموذج عروض الأسعار المخصّصة

ReadinessState

الحالات المحتملة لجاهزية النموذج

عمليات التعداد
READINESS_STATE_UNSPECIFIED الحالة غير محدّدة أو غير معروفة في هذا الإصدار.
READINESS_STATE_ACTIVE تم تدريب النموذج وهو جاهز للعرض.
READINESS_STATE_INSUFFICIENT_DATA لا تتوفّر بيانات كافية لتدريب نموذج العرض.
READINESS_STATE_TRAINING النموذج قيد التدريب وغير جاهز للعرض.
READINESS_STATE_NO_VALID_SCRIPT لم يتم تقديم نص برمجي صالح لعرض الأسعار المخصّص لتدريب النموذج. سيتم تطبيق هذه الحالة فقط على الخوارزميات التي يكون customBiddingAlgorithmType فيها SCRIPT_BASED.

الحالة

الحالات المحتملة لخوارزميات عروض الأسعار المخصّصة

عمليات التعداد
STATE_UNSPECIFIED الحالة غير محدّدة أو غير معروفة في هذا الإصدار.
ENABLED الخوارزمية مفعَّلة، وهي إما مستخدمة مؤخرًا أو مُستخدمة حاليًا أو مُجدولة للاستخدام. تسجّل الخوارزمية مرات الظهور بشكل نشط.
DORMANT لم يتم استخدام الخوارزمية مؤخرًا. رغم أنّ الخوارزمية لا تزال تعمل كـ ENABLED، سيتم تعليقها في النهاية إذا لم يتم استخدامها.
SUSPENDED تعتمد الخوارزمية على تسجيل مرّات الظهور ولا يتوفّر لها نموذج عرض مدرَّب. وإذا تم تخصيص الخوارزمية لعنصر أو تم تعديلها بطريقة أخرى، سيتم التبديل مرة أخرى إلى حالة ENABLED ويتطلب الأمر بعض الوقت لإعداد نموذج العرض مرة أخرى.

الطُرق

create

 تُنشئ خوارزمية جديدة لعروض الأسعار المخصّصة.

get

 الحصول على خوارزمية عروض أسعار مخصّصة

list

 يسرد خوارزميات عروض الأسعار المخصّصة التي يمكن للمستخدِم الحالي الوصول إليها ويمكن استخدامها في استراتيجيات عروض الأسعار.

patch

 يعدِّل خوارزمية عروض أسعار مخصّصة حالية.

uploadScript

 تُنشئ عنصرًا مرجعيًا مخصّصًا لنص برمجي لعروض الأسعار في ملف نص برمجي.