- تمثيل JSON
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- التاريخ
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- المال
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
تمثّل هذه السمة عنوان URL للإجراء مع اللغة المرتبطة به وقائمة البلدان التي تشملها فقط والمنصة الاختيارية التي تشير إلى المنصة التي يجب تنفيذ هذا الإجراء عليها.
تمثيل JSON |
---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
الحقول | |
---|---|
url |
عنوان URL لنقطة الدخول لرابط الإجراء هذا. |
language |
تشير علامة اللغة BCP-47 إلى اللغة التي يتوفّر بها المحتوى من معرّف الموارد المنتظم (URI) هذا. |
restrictedCountry[] |
رمز البلد بصيغة ISO 3166-1 alpha-2. يمكنك ترك هذا الخيار فارغًا لاستخدام الوصول غير المحدود. |
platform |
تمثّل هذه السمة المنصة التي يجب تنفيذ هذا الإجراء عليها. في حال ترك هذا الحقل بدون ضبط، سيتم استخدام ACTION_PLATFORM_WEB_APPLICATION كإجراء احتياطي. |
actionLinkType |
نوع الإجراء المحدّد مسبقًا. |
orderOnlineMetadata |
البيانات الوصفية لرابط الطلب على الإنترنت يدعم اتخاذ إجراء باستخدام ActionLinkType من ACTION_LINK_TYPE_SHOP_online. |
foodOrderingMetadata |
البيانات الوصفية لروابط طلب الطعام نوع الإجراء المتوافق: * |
ActionPlatform
تمثّل هذه السمة المنصّة التي يتم تنفيذ الإجراء عليها. تطبيق الويب هو الإجراء الاحتياطي العام. ننصح باستخدام رابط ActionLink واحد على الأقل مع ACTION_PLATFORM_WEB_APPLICATION. ولا يتم استخدام الروابط بنظامَي التشغيل Android وiOS كنظام أساسي إلا على النظام المعنيّ فقط.
عمليات التعداد | |
---|---|
ACTION_PLATFORM_UNSPECIFIED |
النظام الأساسي غير محدد |
ACTION_PLATFORM_WEB_APPLICATION |
منصة الإجراءات هي الويب بشكل عام. |
ACTION_PLATFORM_MOBILE_WEB |
منصة الإجراءات هي الويب على الأجهزة الجوّالة. |
ACTION_PLATFORM_ANDROID |
نظام التشغيل Android هو نظام التشغيل Android. |
ACTION_PLATFORM_IOS |
منصة الإجراءات هي iOS. |
ActionLinkType
نوع الإجراء المحدّد مسبقًا المرتبط برابط إجراء
عمليات التعداد | |
---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
لم يتم تحديد نوع رابط الإجراء. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
نوع رابط الإجراء هو حجز موعد. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
نوع رابط الإجراء هو حجز موعد على الإنترنت. |
ACTION_LINK_TYPE_ORDER_FOOD |
نوع الرابط الإجراء هو طلب الطعام للتوصيل أو طلب الوجبات الجاهزة لتناولها خارج المطعم أو كليهما. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
نوع الرابط الخاص بالإجراء هو طلب الطعام لتوصيله. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
نوع رابط الإجراء هو طلب الطعام لتناوله خارج المطعم. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
نوع رابط الإجراء هو إجراء حجز لتناول الطعام. |
ACTION_LINK_TYPE_SHOP_ONLINE |
نوع رابط الإجراء هو "طلب" للتسوّق، ويمكن أن يكون "توصيل" أو "استلام الطلب" أو كليهما. |
OrderOnlineMetadata
البيانات الوصفية لرابط إجراء الطلب على الإنترنت.
تمثيل JSON |
---|
{
"fulfillmentOption": [
{
object ( |
الحقول | |
---|---|
fulfillmentOption[] |
خيارات توصيل الطلب المتاحة لرابط اتخاذ إجراء على الإنترنت |
FulfillmentOption
يعرض هذا الحقل خيار تنفيذ الطلب على الإنترنت.
تمثيل JSON |
---|
{ "fulfillmentType": enum ( |
الحقول | |
---|---|
fulfillmentType |
مطلوب. تمثّل هذه السمة نوع توصيل الطلب. |
availableDay[] |
مطلوب. تمثّل هذه السمة قائمة بالأيام التي تتوفّر فيها طريقة توصيل الطلبات هذه (يُفضَّل أن تكون يومين على الأقل). |
feeDetails |
مطلوب. تفاصيل الرسوم لطريقة توصيل الطلب |
minimumOrder |
مطلوب. تمثّل هذه السمة الحدّ الأدنى للطلب لطريقة توصيل الطلبات المرتبطة برابط الإجراء. |
FulfillmentType
نوع التنفيذ المرتبط برابط إجراء
عمليات التعداد | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
لم يتم تحديد نوع توصيل الطلب. |
FULFILLMENT_TYPE_DELIVERY |
إنّ نوع توصيل الطلب هو "التسليم". |
FULFILLMENT_TYPE_PICKUP |
نوع طريقة توفير الطلب هو استلام الطلب. |
AvailableDay
مدى التوفّر على مستوى اليوم
تمثيل JSON |
---|
{
"fulfillmentDate": {
object ( |
الحقول | |
---|---|
fulfillmentDate |
مطلوب. تاريخ متاح لطريقة توصيل الطلب. يتم افتراض أنّ هذه المنتجات مطابقة للمنطقة الزمنية للتاجر. |
lastOrderingTime |
مطلوب. الطابع الزمني لـ Unix آخر مرة تمكّن فيها المستخدم من طلب السلع واستلامها بحلول على سبيل المثال، إذا كانت سمة fulfillmentDate هي 2020-08-10: - تشير القيمة lastOrderingTime بتاريخ 2020-08-10 في الساعة 18:00 إلى أنّ العميل عليه تقديم الطلب في الساعة 6 مساءً في اليوم نفسه ليتمكّن من استلام طلبه في 10-08-2020. - إذا كانت القيمة lastOrderingTime هي 2020-08-08 في الساعة 20:00، يعني ذلك أنّ العميل عليه تقديم طلبه في موعد أقصاه 8 مساءً قبل الساعة 8 مساءً بهدف تلقّي طلبه في 10-08-2020. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
التاريخ
يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
- سنة بمفردها، بشهر صفري ويوم صفري.
- سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
تمثيل JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
الحقول | |
---|---|
year |
السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة. |
month |
شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر، أو 0 لتحديد عام في حد ذاته أو تحديد سنة وشهر حيث لا يكون اليوم مهمًا. |
FeeDetails
تفاصيل الرسوم لطريقة توصيل الطلب المرتبطة برابط الإجراء
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد fee_details . نموذج الرسوم لطريقة توصيل الطلب. يمكن أن يكون fee_details واحدًا فقط مما يلي: |
|
noFee |
لا يتم فرض رسوم على طريقة توصيل الطلبات. |
baseFee |
الرسوم الأساسية المرتبطة بطريقة توصيل الطلبات |
fixedFee |
الرسوم الثابتة المرتبطة بطريقة توصيل الطلبات |
NoFee
لا يلزم دفع أي رسوم لطريقة توصيل الطلب المرتبطة برابط الإجراء.
MinimumFee
تمثّل هذه السمة الحدّ الأدنى للرسوم المطلوبة لطريقة توصيل الطلب المرتبطة برابط الإجراء.
تمثيل JSON |
---|
{
"baseFeeAmount": {
object ( |
الحقول | |
---|---|
baseFeeAmount |
مطلوب. مبلغ الرسوم الأساسية لطريقة توصيل الطلب. |
FixedFee
الرسوم الثابتة المطلوبة لطريقة توصيل الطلب المرتبطة برابط الإجراء.
تمثيل JSON |
---|
{
"amount": {
object ( |
الحقول | |
---|---|
amount |
مطلوب. مبلغ الرسوم الثابتة لطريقة توصيل الطلبات. |
FoodOrderingMetadata
البيانات الوصفية لروابط إجراءات طلب الطعام
تمثيل JSON |
---|
{ "feeDetails": [ { object ( |
الحقول | |
---|---|
feeDetails[] |
تفاصيل الرسوم المفروضة على المستخدم بالإضافة إلى إجمالي المنتجات يتم تكرار هذه الرسوم لأنواع مختلفة من الرسوم، مثل رسوم الخدمة ورسوم التوصيل وغيرها. |
advanceOrderDetails |
تفاصيل حول دعم الطلب المتقدّم، وتُعرف أيضًا باسم الطلب المسبق، حيث يمكن للمستخدم تقديم طلب للتوصيل في وقت لاحق من الوقت الحالي. |
حقل الاتحاد fulfillment_duration_options . المدة الزمنية لتوصيل الطلب بعد تأكيد الطلب بالنسبة إلى طلبات التوصيل، المدة الزمنية حتى يتم توصيل الطعام. المدة الزمنية حتى يصبح الطعام جاهزًا للاستلام بالنسبة إلى طلبات الاستلام يمكن أن يكون fulfillment_duration_options واحدًا فقط مما يلي: |
|
fulfillmentLeadTimeDuration |
مدة ثابتة. على سبيل المثال: 30 دقيقة. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
fulfillmentLeadTimeDurationRange |
نطاق زمني أمثلة: * من 30 دقيقة إلى 45 دقيقة * أكثر من 30 دقيقة * أقل من 50 دقيقة |
FeeDetails
تفاصيل الرسوم
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع الرسوم (معلومات مطلوبة) |
feeAmount |
مبلغ الرسوم بعملة الوحدة أو نسبة مئوية من قيمة سلة التسوّق أو الاثنين معًا (معلومات مطلوبة) |
FeeType
نوع الرسوم
عمليات التعداد | |
---|---|
FEE_TYPE_UNSPECIFIED |
لم يتم تحديد نوع الرسوم. |
DELIVERY |
بالنسبة إلى رسوم التوصيل: |
SERVICE |
بالنسبة إلى رسوم الخدمة: |
FeeAmount
FeeAmount
أمثلة: * الرسوم الثابتة: 0 دولار أمريكي (بدون رسوم)، 1.5 دولار أمريكي * نطاق الرسوم الثابتة: 1.0 دولار أمريكي (بحدّ أدنى)، 3.0 دولار أمريكي (بحد أقصى)، 5.0 إلى 6.0 دولار أمريكي (كحد أقصى)، 5.0 إلى 6.0 دولار أمريكي * النسبة المئوية لحجم سلة التسوّق: 15.5%، 10%-20%، 10% (الحدّ الأدنى)، 15% (الحد الأقصى) * المركّب من النطاق والنسبة المئوية 25% 2.5 دولار أمريكي (الحدّ الأدنى)، 25.5% 4.5 دولارات أمريكية (كحد أقصى) و10% 1.5-2.5 دولار أمريكي، 10.5%-20% 2.5-3.5 دولار أمريكي
تمثيل JSON |
---|
{ "cartPercentage": { object ( |
الحقول | |
---|---|
cartPercentage |
الرسوم بالنسبة المئوية من قيمة سلة التسوّق. يتيح استخدام نطاق (محدد وغير محدود) أو نسبة مئوية ثابتة. يجب أن تتراوح القيمة بين 0 و100. أمثلة: * ثابت 5.5% * 5.5% على الأقل * 5.5% على الأكثر * 4.5% إلى 5.5% |
حقل الاتحاد amount_options . خيارات لتحديد مبلغ نقدي. يمكن أن يكون amount_options واحدًا فقط مما يلي: |
|
amount |
مبلغ ثابت. على سبيل المثال، 3.5 دولار أمريكي. |
amountRange |
نطاق الكمية أمثلة: * من 3.5 إلى 5.5 دولار أمريكي * 3.5 دولار أمريكي على الأقل * 5.5 دولار أمريكي كحدّ أقصى |
amountUnknown |
مبلغ غير معروف. |
المال
يمثل مبلغًا من المال مع نوع العملة.
تمثيل JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
الحقول | |
---|---|
currencyCode |
تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدّد في ISO 4217. |
units |
تمثّل هذه السمة الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة السمة |
nanos |
عدد وحدات نانو (10^-9) من الكمية. يجب أن تتراوح القيمة بين -999,999,999 و +999,999,999 أو أكثر. إذا كانت قيمة |
MoneyRange
ملفوف لنطاق من مبلغ مالي يمكن أن يكون مقيَّدًا أو غير محدود. يجب إدخال قيمة واحدة على الأقل من minAmount وmaxAmount.
تمثيل JSON |
---|
{ "minAmount": { object ( |
الحقول | |
---|---|
minAmount |
الحدّ الأدنى للمبلغ. |
maxAmount |
الحد الأقصى للمبلغ. |
QuantitativeValue
ملفوف لقيمة عددية يمكن أن تكون نطاقًا أو قيمة ثابتة. QuantitativeValue
أمثلة: * القيمة المفردة: value: 10.5
* النطاق المرتبط: valueRange {minValue: 5.5, maxValue 10.5}
* الحد الأدنى: valueRange {minValue: 5.5}
* الحد الأقصى: valueRange {maxValue: 10.5}
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد value_options . (مطلوب) يمكن أن يكون value_options واحدًا فقط مما يلي: |
|
value |
أي قيمة فردية. على سبيل المثال: 5.6 |
valueRange |
مجموعة من القيم التي يمكن أيضًا أن تكون مفتوحة أو محدودة. أمثلة: * 5.5 على الأقل * 5.5 * 5.5 إلى 6.5 على الأكثر |
RangeValue
نطاق القيم التي تجعل minValue
< maxValue
يجب توفّر سمة واحدة على الأقل من minValue
وmaxValue
.
تمثيل JSON |
---|
{ "minValue": number, "maxValue": number } |
الحقول | |
---|---|
minValue |
القيمة الصغرى. |
maxValue |
القيمة القصوى. |
DurationRange
ملفوف لنطاق من المدة يمكن أن يكون مقيَّدًا أو غير محدود. يجب إدخال قيمة واحدة على الأقل لكلّ من minDuration وmaxDuration.
تمثيل JSON |
---|
{ "minDuration": string, "maxDuration": string } |
الحقول | |
---|---|
minDuration |
الحد الأدنى للمدة. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
maxDuration |
الحد الأقصى للمدة. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
AdvanceOrderDetails
للحصول على دعم الطلب المسبق.
تمثيل JSON |
---|
{ "isSupported": boolean } |
الحقول | |
---|---|
isSupported |
صحيح إذا كانت الطلبات المقدّمة، والمعروفة أيضًا باسم "الطلب المسبق"، متاحة. (معلومات مطلوبة) |