Method: events.ingest

يتم تحميل قائمة بموارد Event من Destination المقدَّم.

طلب HTTP

POST https://datamanager.googleapis.com/v1/events:ingest

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  }
}
الحقول
destinations[]

object (Destination)

الحقل مطلوب. قائمة الوجهات التي سيتم إرسال الأحداث إليها
events[]

object (Event)

الحقل مطلوب. قائمة الأحداث المطلوب إرسالها إلى الوجهات المحدّدة يمكن إرسال 2000 مورد من النوع Event كحد أقصى في طلب واحد.
consent

object (Consent)

اختيارية: الموافقة على مستوى الطلب لتطبيقها على جميع المستخدمين في الطلب تتجاوز الموافقة على مستوى المستخدم الموافقة على مستوى الطلب، ويمكن تحديدها في كل Event.
validateOnly

boolean

اختيارية: لأغراض الاختبار إذا كانت القيمة true، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط، وليس النتائج.
encoding

enum (Encoding)

اختيارية: يجب إدخاله لتحميل UserData. نوع ترميز معرّفات المستخدمين بالنسبة إلى معرّفات المستخدمين المجزّأة، هذا هو نوع ترميز السلسلة المجزّأة. بالنسبة إلى معرّفات المستخدمين المشفّرة والمجزّأة، هذا هو نوع ترميز السلسلة المشفّرة الخارجية، ولكن ليس بالضرورة السلسلة المجزّأة الداخلية، ما يعني أنّه يمكن ترميز السلسلة المجزّأة الداخلية بطريقة مختلفة عن السلسلة المشفّرة الخارجية. بالنسبة إلى عمليات التحميل غير المتعلّقة بـ UserData، يتم تجاهل هذا الحقل.
encryptionInfo

object (EncryptionInfo)

اختيارية: معلومات التشفير لعمليات تحميل UserData في حال عدم ضبط هذه السياسة، سيُفترَض أنّ المعلومات التي تكشف الهوية والتي تم تحميلها مجزّأة ولكن غير مشفّرة. بالنسبة إلى عمليات التحميل غير المتعلّقة بـ UserData، يتم تجاهل هذا الحقل.

نص الاستجابة

ردّ من "IngestEventsRequest"

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "requestId": string,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
الحقول
requestId

string

المعرّف الذي تم إنشاؤه تلقائيًا للطلب
fieldWarnings[]

object (FieldWarning)

تحذيرات تفصيلية على مستوى الصف مع مسارات الحقول

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

الحدث

حدث يمثّل تفاعل مستخدم مع الموقع الإلكتروني أو التطبيق الخاصَّين بمعلِن.

تمثيل JSON 
{
  "destinationReferences": [
    string
  ],
  "transactionId": string,
  "eventTimestamp": string,
  "lastUpdatedTimestamp": string,
  "userData": {
    object (UserData)
  },
  "consent": {
    object (Consent)
  },
  "adIdentifiers": {
    object (AdIdentifiers)
  },
  "currency": string,
  "eventSource": enum (EventSource),
  "eventDeviceInfo": {
    object (DeviceInfo)
  },
  "cartData": {
    object (CartData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "experimentalFields": [
    {
      object (ExperimentalField)
    }
  ],
  "userProperties": {
    object (UserProperties)
  },
  "eventName": string,
  "clientId": string,
  "userId": string,
  "additionalEventParameters": [
    {
      object (EventParameter)
    }
  ],
  "thirdPartyUserData": {
    object (UserData)
  },
  "eventLocation": {
    object (EventLocation)
  },
  "appInstanceId": string,
  "callInfo": {
    object (CallInfo)
  },
  "conversionValue": number,
  "conversionCount": number
}
الحقول
destinationReferences[]

string

اختيارية: سلسلة مرجعية تُستخدَم لتحديد الوجهة إذا كان هذا الحقل فارغًا، سيتم إرسال الحدث إلى جميع destinations في الطلب.
transactionId

string

اختيارية: المعرّف الفريد لهذا الحدث مطلوب للأحداث المُرسَلة كمصدر بيانات إضافي للإحالات الناجحة المسجّلة من علامة تتبُّع.
eventTimestamp

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"
lastUpdatedTimestamp

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"
userData

object (UserData)

اختيارية: تمثّل أجزاء البيانات المقدَّمة من المستخدم المستخدم الذي يرتبط به الحدث.
consent

object (Consent)

اختيارية: معلومات حول ما إذا كان المستخدم المرتبط قد قدّم أنواعًا مختلفة من الموافقة
adIdentifiers

object (AdIdentifiers)

اختيارية: المعرّفات والمعلومات الأخرى المستخدَمة لمطابقة حدث الإحالة الناجحة مع نشاط آخر على الإنترنت (مثل النقرات على الإعلانات)
currency

string

اختيارية: رمز العملة المرتبط بجميع القيم المالية ضمن هذا الحدث
eventSource

enum (EventSource)

اختيارية: إشارة إلى مكان وقوع الحدث (الويب أو التطبيق أو داخل المتجر أو غير ذلك)
eventDeviceInfo

object (DeviceInfo)

اختيارية: المعلومات التي تم جمعها عن الجهاز المستخدَم (إن وُجدت) عند وقوع الحدث
cartData

object (CartData)

اختيارية: معلومات عن المعاملة والسلع المرتبطة بالحدث
customVariables[]

object (CustomVariable)

اختيارية: معلومات إضافية عن أزواج المفاتيح/القيم لإرسالها إلى حاويات الإحالات الناجحة (إجراء الإحالة الناجحة أو نشاط Floodlight).
experimentalFields[]

object (ExperimentalField)

اختيارية: قائمة بأزواج المفاتيح والقيم للحقول التجريبية التي قد تتم ترقيتها في النهاية لتصبح جزءًا من واجهة برمجة التطبيقات.
userProperties

object (UserProperties)

اختيارية: معلومات يقيّمها المعلِن عن المستخدم في وقت وقوع الحدث
eventName

string

اختيارية: اسم الحدث مطلوبة لأحداث "إحصاءات Google‏ 4".
clientId

string

اختيارية: معرّف فريد لمثيل المستخدم لعميل تطبيقات الويب لمصدر بيانات من موقع إلكتروني هذا في "إحصاءات Google‏ 4".
userId

string

اختيارية: معرّف فريد لمستخدم، على النحو الذي يحدّده المعلِن.
additionalEventParameters[]

object (EventParameter)

اختيارية: مجموعة من أي مَعلمات خاصة بالحدث ليتم تضمينها في الحدث الذي لم يتم تحديده من قبل باستخدام حقول منظَّمة أخرى.
thirdPartyUserData

object (UserData)

اختيارية: نوع البيانات نفسه المقدَّم في userData، ولكن تم وضع علامة عليه صراحةً على أنّه مقدَّم كبيانات مملوكة لجهة خارجية وليس بيانات معلِن تابعة للطرف الأول.
eventLocation

object (EventLocation)

اختيارية: المعلومات التي تم جمعها عن الموقع الجغرافي للمستخدم عند وقوع هذا الحدث
appInstanceId

string

اختيارية: معرّف فريد لنسخة المستخدم من عميل تطبيق لمصدر بيانات تطبيق "إحصاءات Google‏ 4" هذا
callInfo

object (CallInfo)

اختيارية: المعلومات التي تم جمعها عن المكالمة (إن توفّرت) والتي أدّت إلى هذا الحدث
conversionValue

number

اختيارية: قيمة الإحالة الناجحة المرتبطة بالحدث، وذلك للإحالات الناجحة المستندة إلى القيمة
conversionCount

number

اختيارية: كمية الإحالات الناجحة المرتبطة بالحدث، وذلك للإحالات الناجحة المستندة إلى العدد

AdIdentifiers

المعرّفات والمعلومات الأخرى المستخدَمة لمطابقة حدث الإحالة الناجحة مع نشاط آخر على الإنترنت (مثل النقرات على الإعلانات)

تمثيل JSON 
{
  "sessionAttributes": string,
  "gclid": string,
  "gbraid": string,
  "wbraid": string,
  "landingPageDeviceInfo": {
    object (DeviceInfo)
  },
  "mobileDeviceId": string,
  "dclid": string,
  "impressionId": string,
  "matchId": string,
  "encryptedUserIds": [
    {
      object (EncryptedUserId)
    }
  ],
  "ppid": string,
  "visitorPpid": string,
  "leadId": string
}
الحقول
sessionAttributes

string

اختيارية: سمات الجلسة لتحديد مصدر الأحداث ووضع النماذج
gclid

string

اختيارية: معرّف النقرة من Google ‏(gclid) المرتبط بهذا الحدث
gbraid

string

اختيارية: معرّف النقرة للنقرات المرتبطة بأحداث التطبيق والتي تأتي من أجهزة iOS بدءًا من الإصدار 14 من نظام التشغيل iOS
wbraid

string

اختيارية: معرّف النقرة للنقرات المرتبطة بأحداث الويب والتي تأتي من أجهزة iOS بدءًا من الإصدار 14 من نظام التشغيل iOS
landingPageDeviceInfo

object (DeviceInfo)

اختيارية: المعلومات التي يتم جمعها عن الجهاز المستخدَم (إن وُجدت) في وقت الوصول إلى موقع المعلِن الإلكتروني بعد التفاعل مع الإعلان.
mobileDeviceId

string

اختيارية: المعرّف على الأجهزة الجوّالة للمعلِنين ويكون ذلك معرّف المعلِنين (IDFA) على أجهزة iOS أو المعرّف الإعلاني (AdID) على أجهزة Android أو معرّفات المعلِنين على الأنظمة الأساسية الأخرى.
dclid

string

اختيارية: معرّف النقرة على الشبكة الإعلانية المرتبط بهذا الحدث
impressionId

string

اختيارية: معرّف مرّة الظهور المرتبط بهذا الحدث
matchId

string

اختيارية: حقل رقم التعريف المطابق المستخدَم لربط هذا الحدث بحدث سابق
encryptedUserIds[]

object (EncryptedUserId)

اختيارية: أي عدد من أرقام تعريف المستخدمين المشفّرة
ppid

string

اختيارية: معرّف فريد لمستخدم تمت مصادقته (سجّل الدخول)، على النحو الذي يحدّده الناشر.
visitorPpid

string

اختيارية: معرّف فريد لمستخدم لم تتم مصادقته (مستخدم لم يسجّل الدخول)، على النحو الذي يحدّده الناشر.
leadId

string

اختيارية: معرّف من إنشاء Google يتم إصداره عندما يرسل المستخدم نموذج عملاء محتملين

EncryptedUserId

معرّف مستخدم يتم إصداره لاستخدامه في تحديد المصدر. يجب ملء جميع الحقول في حال استخدام هذه السمة.

تمثيل JSON 
{
  "encryptedId": string,
  "entityType": enum (EncryptionEntityType),
  "entityId": string,
  "source": enum (EncryptionSource)
}
الحقول
encryptedId

string

الحقل مطلوب. المعرّف المشفّر الأبجدي الرقمي
entityType

enum (EncryptionEntityType)

الحقل مطلوب. نوع كيان التشفير يجب أن يتطابق هذا مع إعدادات التشفير لعرض الإعلانات أو نقل البيانات.
entityId

string (int64 format)

الحقل مطلوب. رقم تعريف كيان التشفير يجب أن يتطابق هذا مع إعدادات التشفير لعرض الإعلانات أو نقل البيانات.
source

enum (EncryptionSource)

الحقل مطلوب. توضّح ما إذا تم تلقّي ملف تعريف الارتباط المشفّر من عرض الإعلانات (وحدة الماكرو %m) أو من "نقل البيانات".

EncryptionEntityType

نوع كيان التشفير

عمليات التعداد
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED نوع كيان التشفير غير محدّد.
CAMPAIGN_MANAGER_ACCOUNT حساب على "مدير الحملة 360"
CAMPAIGN_MANAGER_ADVERTISER معلِن في "مدير الحملة 360"
DISPLAY_VIDEO_PARTNER شريك "مساحة العرض والفيديو 360"
DISPLAY_VIDEO_ADVERTISER مُعلِن على "مساحة العرض والفيديو 360"
GOOGLE_ADS_CUSTOMER عميل "إعلانات Google"
GOOGLE_AD_MANAGER_NETWORK_CODE رمز شبكة "إدارة إعلانات Google"

EncryptionSource

مصدر التشفير

عمليات التعداد
ENCRYPTION_SOURCE_UNSPECIFIED مصدر التشفير غير محدّد.
AD_SERVING مصدر تشفير عرض الإعلانات
DATA_TRANSFER مصدر تشفير نقل البيانات

EventSource

مصدر الحدث

عمليات التعداد
EVENT_SOURCE_UNSPECIFIED لم يتم تحديد EventSource. يجب عدم استخدامها مطلقًا.
WEB تم إنشاء الحدث من متصفّح ويب.
APP تم إنشاء الحدث من تطبيق.
IN_STORE تم إنشاء الحدث من معاملة في المتجر.
PHONE تم إنشاء الحدث من مكالمة هاتفية.
MESSAGE تم إنشاء الحدث من رسالة.
OTHER تم إنشاء الحدث من مصادر أخرى.

CartData

بيانات سلة التسوّق المرتبطة بالحدث

تمثيل JSON 
{
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "transactionDiscount": number,
  "items": [
    {
      object (Item)
    }
  ],
  "couponCodes": [
    string
  ]
}
الحقول
merchantId

string

اختيارية: معرّف Merchant Center المرتبط بالسلع
merchantFeedLabel

string

اختيارية: تصنيف الخلاصة في Merchant Center المرتبط بخلاصة السلع
merchantFeedLanguageCode

string

اختيارية: رمز اللغة وفقًا لمعيار ISO 639-1 المرتبط بخلاصة Merchant Center التي تم تحميل سلعك فيها
transactionDiscount

number

اختيارية: مجموع كل الخصومات المرتبطة بالمعاملة
items[]

object (Item)

اختيارية: قائمة السلع المرتبطة بالحدث
couponCodes[]

string

اختيارية: قائمة رموز القسائم التي تم تطبيقها على سلة التسوّق تكون رموز القسائم على مستوى سلة التسوّق وعلى مستوى السلعة مستقلة.

إذا كان الحدث مخصّصًا لوجهة في "إحصاءات Google"، قدِّم رمز قسيمة واحدًا فقط. وتتجاهل "إحصاءات Google" رموز القسائم الإضافية.

العنصر

يمثّل سلعة في سلة التسوّق مرتبطة بالحدث.

تمثيل JSON 
{
  "merchantProductId": string,
  "quantity": string,
  "unitPrice": number,
  "itemId": string,
  "additionalItemParameters": [
    {
      object (ItemParameter)
    }
  ],
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "customVariables": [
    {
      object (ItemCustomVariable)
    }
  ],
  "conversionValue": number
}
الحقول
merchantProductId

string

اختيارية: معرّف المنتج ضمن حساب Merchant Center
quantity

string (int64 format)

اختيارية: عدد هذه السلعة المرتبطة بالحدث
unitPrice

number

اختيارية: سعر الوحدة غير شامل للضرائب أو تكاليف الشحن أو أيّ خصومات على مستوى المُعاملة.
itemId

string

اختيارية: معرّف فريد للإشارة إلى السلعة
additionalItemParameters[]

object (ItemParameter)

اختيارية: مجموعة من أي مَعلمات خاصة بالحدث ذات صلة بسلعة ليتم تضمينها في الحدث الذي لم يسبق تحديده باستخدام حقول منظَّمة أخرى.
merchantId

string

اختيارية: معرّف Merchant Center المرتبط بالسلعة بالنسبة إلى أحداث المبيعات في المتاجر، سيؤدي ذلك إلى إلغاء القيمة المحدّدة على مستوى سلة التسوّق. ويتم تجاهل هذا الحقل للأحداث الأخرى.
merchantFeedLabel

string

اختيارية: تصنيف خلاصة Merchant Center إذا كانت البلدان لا تزال مستخدَمة، يمكن استخدام رمز البلد المكوّن من حرفَين حسب المعيار ISO-3166-1 alpha-2 بدلاً من ذلك. بالنسبة إلى أحداث المبيعات في المتاجر، سيؤدي ذلك إلى إلغاء القيمة المحدّدة على مستوى سلة التسوّق. ويتم تجاهل هذا الحقل للأحداث الأخرى.
merchantFeedLanguageCode

string

اختيارية: رمز اللغة وفقًا لمعيار ISO 639-1 المرتبط بخلاصة Merchant Center التي يتم تحميل سلعك فيها
customVariables[]

object (ItemCustomVariable)

اختيارية: معلومات إضافية عن أزواج المفاتيح/القيم لإرسالها إلى حاويات الإحالات الناجحة (إجراء الإحالة الناجحة أو نشاط Floodlight)، عند تتبُّع الإحالات الناجحة لكل سلعة.
conversionValue

number

اختيارية: قيمة الإحالة الناجحة المرتبطة بهذا العنصر ضمن الحدث، في الحالات التي تختلف فيها قيمة الإحالة الناجحة لكل عنصر.

ItemParameter

مجموعة من أي مَعلمات خاصة بالحدث ذات صلة بسلعة ليتم تضمينها في الحدث الذي لم يسبق تحديده باستخدام حقول منظَّمة أخرى.

تمثيل JSON 
{
  "parameterName": string,
  "value": string
}
الحقول
parameterName

string

الحقل مطلوب. اسم المَعلمة المطلوب استخدامها
value

string

الحقل مطلوب. تمثيل السلسلة لقيمة المَعلمة المطلوب ضبطها

ItemCustomVariable

متغيّر مخصّص على مستوى السلعة للإحالات الناجحة للإعلانات

تمثيل JSON 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
الحقول
variable

string

اختيارية: اسم المتغيّر المخصّص المطلوب ضبطه. إذا لم يتم العثور على المتغيّر للوجهة المحدّدة، سيتم تجاهله.
value

string

اختيارية: القيمة المطلوب تخزينها للمتغيّر المخصّص
destinationReferences[]

string

اختيارية: سلسلة مرجعية تُستخدَم لتحديد أيّ من Event.destination_references يجب إرسال المتغيّر المخصّص إليه. إذا كان الحقل فارغًا، سيتم استخدام Event.destination_references.

المتغيّر المخصّص

متغيّر مخصّص للإحالات الناجحة في "إعلانات Google"

تمثيل JSON 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
الحقول
variable

string

اختيارية: اسم المتغيّر المخصّص المطلوب ضبطه. إذا لم يتم العثور على المتغيّر للوجهة المحدّدة، سيتم تجاهله.
value

string

اختيارية: القيمة المطلوب تخزينها للمتغيّر المخصّص
destinationReferences[]

string

اختيارية: سلسلة مرجعية تُستخدَم لتحديد أيّ من Event.destination_references يجب إرسال المتغيّر المخصّص إليه. إذا كان الحقل فارغًا، سيتم استخدام Event.destination_references.

ExperimentalField

حقل تجريبي يمثّل الحقول غير الرسمية

تمثيل JSON 
{
  "field": string,
  "value": string
}
الحقول
field

string

اختيارية: اسم الحقل المطلوب استخدامه
value

string

اختيارية: القيمة التي يجب ضبطها في الحقل

UserProperties

معلومات يقيّمها المعلِن عن المستخدم في وقت وقوع الحدث لمزيد من التفاصيل، يُرجى الانتقال إلى https://support.google.com/google-ads/answer/14007601.

تمثيل JSON 
{
  "customerType": enum (CustomerType),
  "customerValueBucket": enum (CustomerValueBucket),
  "additionalUserProperties": [
    {
      object (UserProperty)
    }
  ]
}
الحقول
customerType

enum (CustomerType)

اختيارية: نوع العميل المرتبط بالحدث
customerValueBucket

enum (CustomerValueBucket)

اختيارية: القيمة التي يقيّمها المعلِن للعميل
additionalUserProperties[]

object (UserProperty)

اختيارية: مجموعة من أي خصائص مستخدم إضافية للمستخدم المرتبط بهذا الحدث

CustomerType

نوع العميل المرتبط بالحدث

عمليات التعداد
CUSTOMER_TYPE_UNSPECIFIED نوع العميل غير محدّد. يجب عدم استخدامها مطلقًا.
NEW العميل جديد بالنسبة إلى المعلِن.
RETURNING يعود العميل إلى المعلِن.
REENGAGED أعاد العميل التفاعل مع المعلِن.

CustomerValueBucket

القيمة التي يقيّمها المعلِن للعميل

عمليات التعداد
CUSTOMER_VALUE_BUCKET_UNSPECIFIED ‫CustomerValueBucket غير محدّد يجب عدم استخدامها مطلقًا.
LOW العميل ذو قيمة منخفضة.
MEDIUM العميل ذو قيمة متوسطة.
HIGH العميل بارز.

UserProperty

مجموعة من أي خصائص مستخدم إضافية للمستخدم المرتبط بهذا الحدث

تمثيل JSON 
{
  "propertyName": string,
  "value": string
}
الحقول
propertyName

string

الحقل مطلوب. تمثّل هذه المَعلمة اسم خاصية المستخدم المطلوب استخدامها.
value

string

الحقل مطلوب. تمثيل السلسلة لقيمة خاصية المستخدم المطلوب استخدامها

EventParameter

مَعلمة خاصة بأحداث "إحصاءات Google‏ 4"

تمثيل JSON 
{
  "parameterName": string,
  "value": string
}
الحقول
parameterName

string

الحقل مطلوب. اسم المَعلمة المطلوب استخدامها
value

string

الحقل مطلوب. تمثيل السلسلة لقيمة المَعلمة المطلوب ضبطها

EventLocation

الموقع الجغرافي الذي وقع فيه الحدث

تمثيل JSON 
{
  "storeId": string,
  "city": string,
  "subdivisionCode": string,
  "regionCode": string,
  "subcontinentCode": string,
  "continentCode": string
}
الحقول
storeId

string

اختيارية: مطلوبة للمبيعات في المتاجر. المعرّف الذي يمثّل متجرًا حدث فيه الحدث
city

string

اختيارية: اسم المدينة التي وقع فيها الحدث
subdivisionCode

string

اختيارية: رمز التقسيم الفرعي وفقًا لمعيار ISO 3166-2 الذي وقع فيه الحدث
regionCode

string

اختيارية: رمز المنطقة المكوّن من حرفَين حسب معيار CLDR لعنوان المستخدم
subcontinentCode

string

اختيارية: رمز شبه القارة بتنسيق UN M49 حيث وقع الحدث
continentCode

string

اختيارية: رمز القارة بتنسيق UN M49 حيث وقع الحدث

CallInfo

المعلومات التي تم جمعها عن المكالمة (إن توفّرت) والتي أدّت إلى هذا الحدث

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

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"