REST Resource: customBiddingAlgorithms.scripts

المورد: CustomBiddingScript

نص برمجي واحد لعروض الأسعار المخصّصة

تمثيل JSON
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "customBiddingScriptId": string,
  "createTime": string,
  "active": boolean,
  "state": enum (State),
  "errors": [
    {
      object (ScriptError)
    }
  ],
  "script": {
    object (CustomBiddingScriptRef)
  }
}
الحقول
name

string

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

customBiddingAlgorithmId

string (int64 format)

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

customBiddingScriptId

string (int64 format)

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

createTime

string (Timestamp format)

للعرض فقط. وقت إنشاء النص البرمجي

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

active

boolean

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

state

enum (State)

للعرض فقط. حالة نص عرض الأسعار المخصّص البرمجي

errors[]

object (ScriptError)

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

script

object (CustomBiddingScriptRef)

يشير إلى ملف النص البرمجي الذي تم تحميله.

ولاية

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

عمليات التعداد
STATE_UNSPECIFIED لم يتم تحديد حالة النص البرمجي أو أنّها غير معروفة في هذا الإصدار.
ACCEPTED تم قبول النص البرمجي لتسجيل مرّات الظهور.
REJECTED تم رفض النص البرمجي من خلال مسارات الخلفية. قد يحتوي على أخطاء.
PENDING تتم معالجة النص البرمجي لمسارات الخلفية.

ScriptError

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

تمثيل JSON
{
  "errorCode": enum (ErrorCode),
  "line": string,
  "column": string,
  "errorMessage": string
}
الحقول
errorCode

enum (ErrorCode)

نوع الخطأ

line

string (int64 format)

رقم السطر في النص البرمجي الذي حدث فيه الخطأ

column

string (int64 format)

رقم العمود في النص البرمجي الذي حدث فيه الخطأ

errorMessage

string

رسالة الخطأ المفصَّلة

ErrorCode

رموز الأخطاء المحتملة لخطأ في نص برمجي لعروض الأسعار المخصّصة

عمليات التعداد
ERROR_CODE_UNSPECIFIED خطأ النص البرمجي غير محدّد أو غير معروف في هذا الإصدار.
SYNTAX_ERROR يحتوي النص البرمجي على خطأ في البنية.
DEPRECATED_SYNTAX يستخدم النص البرمجي بنية متوقفة نهائيًا.
INTERNAL_ERROR حدثت أخطاء داخلية أثناء معالجة النص البرمجي.

CustomBiddingScriptRef

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

تمثيل JSON
{
  "resourceName": string
}
الحقول
resourceName

string

اسم مورد سيتم استخدامه في media.download لتنزيل ملفات النصوص البرمجية أو media.upload لتحميل ملفات النصوص البرمجية. تكون أسماء الموارد بالتنسيق customBiddingAlgorithms/{customBiddingAlgorithmId}/scriptRef/{ref_id}.

الطُرق

create

يؤدي هذا الإجراء إلى إنشاء نص برمجي جديد لعروض الأسعار المخصّصة.

get

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

list

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