- تمثيل JSON
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- التاريخ
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- الأرباح
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
- EventMetadata
- Surface
عنوان URL للإجراء مع اللغة المرتبطة وقائمة البلدان التي يقتصر عليها الإجراء والنظام الأساسي الاختياري الذي يشير إلى النظام الأساسي الذي يجب تنفيذ هذا الإجراء عليه
| تمثيل JSON |
|---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
| الحقول | |
|---|---|
url |
تمثّل هذه السمة عنوان URL لنقطة الدخول الخاصة برابط لاتّخاذ إجراء هذا. |
language |
علامة اللغة BCP-47 التي تحدّد اللغة التي يتوفّر بها المحتوى من معرّف الموارد المنتظم هذا |
restrictedCountry[] |
رمز البلد المكوّن من حرفين وفقًا لمعيار ISO 3166-1 alpha-2 اترك هذا الحقل فارغًا إذا كنت تريد أن يكون المحتوى مرئيًا للجميع. |
platform |
النظام الأساسي الذي يجب تنفيذ هذا الإجراء عليه. في حال عدم ضبط هذا الحقل، سيتم استخدام ACTION_PLATFORM_WEB_APPLICATION كخيار بديل. |
actionLinkType |
نوع الإجراء المحدّد مسبقًا. |
orderOnlineMetadata |
تمثّل هذه السمة البيانات الوصفية الخاصة برابط الطلب على الإنترنت. يتيح تنفيذ إجراء بنوع ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE. |
foodOrderingMetadata |
البيانات الوصفية لروابط طلب الطعام يتوافق مع نوع الإجراء: * |
eventMetadata |
معلومات إضافية حول رابط لاتّخاذ إجراء، وهي فريدة بالنسبة إلى فئة الأحداث. |
ActionPlatform
النظام الأساسي الذي يتم تنفيذ الإجراء عليه. تطبيق الويب هو الخيار الاحتياطي العام. يُنصح بتضمين رابط ActionLink واحد على الأقل مع ACTION_PLATFORM_WEB_APPLICATION. لا تُستخدَم الروابط التي تتضمّن Android وiOS كنظام أساسي إلا على النظام المعنيّ.
| عمليات التعداد | |
|---|---|
ACTION_PLATFORM_UNSPECIFIED |
لم يتم تحديد النظام الأساسي. |
ACTION_PLATFORM_WEB_APPLICATION |
منصة الإجراءات هي الويب بشكل عام. |
ACTION_PLATFORM_MOBILE_WEB |
منصة الإجراء هي الويب على الأجهزة الجوّالة. |
ACTION_PLATFORM_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 مساءً من اليوم نفسه لتلقّيه في 2020-08-10. - تشير قيمة lastOrderingTime البالغة 20:00 2020-08-08 إلى أنّه لكي يتلقّى العميل طلبه في 2020-08-10، عليه تقديم الطلب بحلول الساعة 8 مساءً قبل يومَين. يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
التاريخ
تمثّل هذه السمة تاريخًا كاملاً أو جزئيًا في التقويم، مثل تاريخ الميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا أهمية لهما. التاريخ نسبي بالنسبة إلى التقويم الغريغوري. يمكن أن يمثّل ذلك أحد ما يلي:
- تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
- الشهر واليوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية)
- سنة بمفردها، مع شهر ويوم بقيمة صفر
- سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة ائتمان).
أنواع ذات صلة:
google.type.TimeOfDaygoogle.type.DateTimegoogle.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 دولار أمريكي * النسبة المئوية لحجم سلة التسوّق: 15.5%، من 10% إلى 20%، 10% (الحدّ الأدنى)، 15% (الحدّ الأقصى) * مزيج من النطاق والنسبة المئوية: 25.5% و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
حاوية لقيمة رقمية يمكن أن تكون نطاقًا أو قيمة ثابتة. أمثلة: * قيمة مفردة: value: 10.5 * نطاق محدود: valueRange {minValue: 5.5, maxValue 10.5} * الحد الأدنى: valueRange {minValue: 5.5} * الحد الأقصى: valueRange {maxValue: 10.5}QuantitativeValue
| تمثيل 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 |
تكون القيمة صحيحة إذا كانت الطلبات المسبقة، المعروفة أيضًا باسم "الطلب مسبقًا"، متاحة. (معلومات مطلوبة) |
EventMetadata
معلومات إضافية حول رابط لاتّخاذ إجراء، وهي فريدة بالنسبة إلى فئة الأحداث.
| تمثيل JSON |
|---|
{
"surface": enum ( |
| الحقول | |
|---|---|
surface |
مساحة عرض الحدث المحدّدة مسبقًا والمرتبطة برابط لاتّخاذ إجراء يتم استخدام هذا الخيار فقط في فئة "الأحداث". |
مساحات العرض
مساحة عرض الحدث المحدّدة مسبقًا والمرتبطة برابط لاتّخاذ إجراء يتم استخدام هذا الخيار فقط في فئة "الأحداث".
| عمليات التعداد | |
|---|---|
SURFACE_UNSPECIFIED |
لم يتم تحديد السطح. |
SURFACE_SEARCH |
رابط لاتّخاذ إجراء هو حجز تذكرة لحضور فعالية في "بحث Google". |
SURFACE_YOUTUBE |
رابط لاتّخاذ إجراء هو حجز تذكرة لحضور فعالية في YouTube. |
SURFACE_ADS |
رابط لاتّخاذ إجراء هو النقر على إعلان عن الحدث. |