- تمثيل 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 التي تحدّد اللغة التي يتوفّر بها المحتوى من عنوان URL هذا |
restricted |
رمز البلد بصيغة ISO 3166-1 alpha-2. يمكنك ترك هذا الخيار فارغًا لاستخدام الوصول غير المحدود. |
platform |
النظام الأساسي الذي يجب تنفيذ هذا الإجراء عليه في حال عدم ضبط هذا الحقل، سيتم استخدام ACTION_PLATFORM_WEB_APPLICATION كخيار احتياطي. |
action |
نوع الإجراء المحدّد مسبقًا. |
order |
البيانات الوصفية لرابط الطلب على الإنترنت يدعم اتخاذ إجراء باستخدام ActionLinkType من ACTION_LINK_TYPE_SHOP_online. |
food |
البيانات الوصفية لعناوين روابط طلب الطعام تتيح نوع الإجراء: * |
event |
معلومات إضافية عن رابط الإجراء الفريد الخاص بقطاع الأحداث |
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 ( |
الحقول | |
---|---|
fulfillment |
خيارات توصيل الطلب المتاحة لرابط اتخاذ إجراء على الإنترنت |
FulfillmentOption
خيار التنفيذ لرابط إجراء الطلب على الإنترنت
تمثيل JSON |
---|
{ "fulfillmentType": enum ( |
الحقول | |
---|---|
fulfillment |
مطلوب. نوع توصيل الطلب |
available |
مطلوب. تمثّل هذه السمة قائمة بالأيام التي تتوفّر فيها طريقة توصيل الطلبات هذه (يُفضَّل أن تكون يومين على الأقل). |
fee |
مطلوب. تفاصيل الرسوم لطريقة توصيل الطلب |
minimum |
مطلوب. الحد الأدنى للطلب لطريقة التسليم المرتبطة برابط الإجراء |
FulfillmentType
نوع الإنجاز المرتبط برابط إجراء
عمليات التعداد | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
لم يتم تحديد نوع التسليم. |
FULFILLMENT_TYPE_DELIVERY |
نوع توصيل الطلب هو "التسليم". |
FULFILLMENT_TYPE_PICKUP |
نوع طريقة توفير الطلب هو استلام الطلب. |
AvailableDay
مدى التوفّر على مستوى اليوم
تمثيل JSON |
---|
{
"fulfillmentDate": {
object ( |
الحقول | |
---|---|
fulfillment |
مطلوب. تاريخ متاح لطريقة التسليم يُفترض أن تكون في المنطقة الزمنية للتاجر. |
last |
مطلوب. الطابع الزمني لنظام التشغيل يونكس آخر مرة تمكّن فيها المستخدم من طلب السلع واستلامها بحلول على سبيل المثال، إذا كانت سمة fulfillmentDate هي 2020-08-10: - تشير القيمة lastOrderingTime التي تبلغ 2020-08-10 في الساعة 18:00 إلى أنّ العميل عليه تقديم الطلب في الساعة 6 مساءً في اليوم نفسه ليتمكّن من استلام طلبه في 10-08-2020. - إذا كانت قيمة lastOrderingTime هي 2020-08-08 20:00، يعني ذلك أنّه كي يتلقّى العميل طلبه في 2020-08-10، عليه تقديم هذا الطلب بحلول الساعة 8 مساءً قبل يومَين. طابع زمني بتنسيق 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 واحدًا فقط مما يلي: |
|
no |
لا يتم تحصيل رسوم مقابل طريقة التسليم. |
base |
الرسوم الأساسية المرتبطة بطريقة توصيل الطلبات |
fixed |
الرسوم الثابتة المرتبطة بطريقة التسليم |
NoFee
لا يحتوي هذا النوع على أي حقول.
لا تُفرض أي رسوم على طريقة الإنجاز المرتبطة برابط الإجراء.
MinimumFee
الحد الأدنى للرسوم المطلوبة لطريقة التسليم المرتبطة برابط الإجراء.
تمثيل JSON |
---|
{
"baseFeeAmount": {
object ( |
الحقول | |
---|---|
base |
مطلوب. مبلغ الرسوم الأساسية لطريقة التسليم |
FixedFee
الرسوم الثابتة المطلوبة لطريقة التسليم المرتبطة برابط الإجراء
تمثيل JSON |
---|
{
"amount": {
object ( |
الحقول | |
---|---|
amount |
مطلوب. مبلغ الرسوم الثابتة لطريقة التسليم |
FoodOrderingMetadata
البيانات الوصفية لروابط إجراءات طلب الطعام
تمثيل JSON |
---|
{ "feeDetails": [ { object ( |
الحقول | |
---|---|
fee |
تفاصيل الرسوم التي يتم تحصيلها من المستخدم بالإضافة إلى إجمالي سعر السلع يتم تكرار هذا الإجراء لأنواع مختلفة من الرسوم، مثل رسوم الخدمة ورسوم التسليم وما إلى ذلك. |
advance |
تفاصيل حول دعم الطلب المتقدّم، وتُعرف أيضًا باسم الطلب المسبق، حيث يمكن للمستخدم تقديم طلب للتوصيل في وقت لاحق من الوقت الحالي. |
حقل الربط fulfillment_duration_options المدة الزمنية لتوصيل الطلب بعد تأكيد الطلب بالنسبة إلى طلبات التوصيل، المدة الزمنية حتى يتم توصيل الطعام. بالنسبة إلى طلبات الاستلام، يشير ذلك إلى المدة الزمنية التي سيستغرقها الطعام حتى يصبح جاهزًا للاستلام. يمكن أن يكون fulfillment_duration_options واحدًا فقط مما يلي: |
|
fulfillment |
مدة ثابتة على سبيل المثال: 30 دقيقة. المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
fulfillment |
نطاق زمني أمثلة: * من 30 دقيقة إلى 45 دقيقة * أكثر من 30 دقيقة * أقل من 50 دقيقة |
FeeDetails
تفاصيل الرسوم
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع الرسوم (معلومات مطلوبة) |
fee |
مبلغ الرسوم إما بعملة الوحدة أو نسبة مئوية من قيمة سلة التسوّق أو كليهما. (معلومات مطلوبة) |
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 ( |
الحقول | |
---|---|
cart |
الرسوم بالنسبة المئوية من قيمة سلة التسوّق. يتيح استخدام نطاق (محدود وغير محدود) أو نسبة مئوية ثابتة. يجب أن تتراوح القيمة بين 0 و100. أمثلة: * ثابتة بنسبة %5.5 * %5.5 على الأقل * %5.5 بحد أقصى * من %4.5 إلى %5.5 |
حقل الاتحاد amount_options . خيارات لتحديد المبلغ النقدي يمكن أن يكون amount_options واحدًا فقط مما يلي: |
|
amount |
مبلغ ثابت. على سبيل المثال، 3.5 دولار أمريكي. |
amount |
نطاق المبلغ أمثلة: * من 3.5 إلى 5.5 دولار أمريكي * 3.5 دولار أمريكي على الأقل * 5.5 دولار أمريكي كحدّ أقصى |
amount |
مبلغ غير معروف. |
المال
يمثل مبلغًا من المال مع نوع العملة.
تمثيل JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
الحقول | |
---|---|
currency |
تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدّد في ISO 4217. |
units |
تمثّل هذه السمة الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة |
nanos |
عدد وحدات نانو (10^-9) من الكمية. يجب أن تتراوح القيمة بين -999,999,999 و +999,999,999 أو أكثر. إذا كانت |
MoneyRange
غلاف لنطاق من المبالغ النقدية التي يمكن أن تكون محدودة أو غير محدودة يجب توفير سمة واحدة على الأقل من minAmount وmaxAmount.
تمثيل JSON |
---|
{ "minAmount": { object ( |
الحقول | |
---|---|
min |
الحد الأدنى للمبلغ |
max |
الحد الأقصى للمبلغ |
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 |
value |
نطاق من القيم التي يمكن أيضًا أن تكون مفتوحة أو محدودة. أمثلة: * 5.5 على الأقل * 5.5 * 5.5 إلى 6.5 على الأكثر |
RangeValue
نطاق القيم التي تجعل minValue
< maxValue
يلزم توفير سمة واحدة على الأقل من minValue
وmaxValue
.
تمثيل JSON |
---|
{ "minValue": number, "maxValue": number } |
الحقول | |
---|---|
min |
القيمة الصغرى. |
max |
القيمة القصوى. |
DurationRange
ملفوف لنطاق من المدة يمكن أن يكون مقيَّدًا أو غير محدود. يجب توفير سمة واحدة على الأقل من سمتَي minDuration وmaxDuration.
تمثيل JSON |
---|
{ "minDuration": string, "maxDuration": string } |
الحقول | |
---|---|
min |
الحد الأدنى للمدة. المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
max |
الحد الأقصى للمدة. المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
AdvanceOrderDetails
للحصول على دعم الطلب المسبق.
تمثيل JSON |
---|
{ "isSupported": boolean } |
الحقول | |
---|---|
is |
صحيح إذا كانت الطلبات المقدّمة، والمعروفة أيضًا باسم "الطلب المسبق"، متاحة. (معلومات مطلوبة) |
EventMetadata
معلومات إضافية عن رابط الإجراء الذي يكون فريدًا لقطاع الأحداث
تمثيل JSON |
---|
{
"surface": enum ( |
الحقول | |
---|---|
surface |
مساحة عرض الحدث المحدّدة مسبقًا والمرتبطة برابط إجراء لا يُستخدَم هذا الإجراء إلّا في مجال "الفعاليات". |
مساحات العرض
مساحة عرض حدث محددة مسبقًا مرتبطة برابط إجراء. لا يُستخدَم هذا الإجراء إلّا في مجال "الفعاليات".
عمليات التعداد | |
---|---|
SURFACE_UNSPECIFIED |
لم يتم تحديد سطح. |
SURFACE_SEARCH |
رابط الإجراء هو حجز تذكرة فعالية في "بحث Google". |
SURFACE_YOUTUBE |
ينقل رابط الإجراء إلى صفحة حجز تذكرة لحضور حدث على YouTube. |
SURFACE_ADS |
يتمثل رابط الإجراء في النقر على إعلان للحدث. |