- تمثيل JSON
- PurchaseItemExtension
- MerchantUnitMeasure
- ItemOption
- ProductDetails
- ReservationItemExtension
- StaffFacilitator
يحتوي عنصر واحد على موضع إعلان واحد. يمكن أن يحتوي الطلب أو سلة التسوق على عناصر متعددة من المجال نفسه. يجب تحديد عناصر الأسطر الفرعية/الإضافات وما إلى ذلك في النماذج الأوّلية الرأسية اعتمادًا على حالات استخدامها. ملاحظة: 1. يجب أن تكون جميع السلاسل في جميع المستويات أقل من 1000 حرف ما لم يتم تحديد خلاف ذلك. 2. يجب أن تكون جميع الحقول المتكرّرة في جميع المستويات أقل من 50 في العدد ما لم يتم تحديد خلاف ذلك. 3. يجب أن تكون جميع الطوابع الزمنية على جميع المستويات، إذا تم تحديدها، طوابع زمنية صالحة.
تمثيل JSON | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
الحقول | ||
---|---|---|
id |
مطلوب: معرّف التاجر الذي عيّنه للعنصر. تُستخدَم لتحديد العنصر الحالي عند تطبيق التعديلات الجزئية. الحد الأقصى المسموح به للطول هو 64 حرفًا. |
|
name |
اسم البند كما هو معروض في الإيصال. الحد الأقصى المسموح به للطول هو 100 حرف. |
|
userVisibleStateLabel |
تمّ الإيقاف. استخدِم الحالة على المستوى العمودي بدلاً من ذلك. على سبيل المثال، بالنسبة إلى عمليات الشراء، يمكنك استخدام purchaseOrderExtension.status. تصنيف مرئي للمستخدم لحالة هذا العنصر. |
|
provider |
تمثّل هذه السمة موفِّر العنصر المعيّن، إذا كان مختلفًا عن الطلب الكلي. مثال: طلب Expedia من خلال مزوّد تفاصيل الإعلانات ANA |
|
priceAttributes[] |
السعر والتسويات على مستوى العنصر |
|
followUpActions[] |
إجراءات المتابعة على البند. |
|
recipients[] |
للعملاء على مستوى العنصر، قد يختلف هذا العنصر عن المشتري على مستوى الطلب. مثال: أجرى المستخدم "س" حجز مطعم باسم المستخدم "ص". |
|
image |
صورة صغيرة مرتبطة بهذا العنصر، إن توفّرت. |
|
description |
وصف العنصر. |
|
notes[] |
ملاحظات إضافية تنطبق على هذا العنصر تحديدًا، على سبيل المثال سياسة الإلغاء. |
|
disclosures[] |
الإفصاحات المرتبطة بهذا العنصر |
|
vertical |
مهملة: يمكنك استخدام مواضع الإعلانات بدلاً من ذلك. مطلوب: المحتوى الدلالي للعنصر بناءً على نوعه أو مجاله. يجب أن يتضمن كل مجال تفاصيل توصيله. يجب استخدام إحدى القيمتَين التاليتَين: كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
|
حقل الاتحاد verticals مطلوب: المحتوى الدلالي للعنصر بناءً على نوعه أو مجاله. يجب أن يتضمن كل مجال تفاصيل توصيله. يمكن أن تكون السمة "verticals " واحدة فقط مما يلي: |
||
purchase |
طلبات الشراء مثل السلع والأطعمة وغيرها |
|
reservation |
طلبات الحجز مثل المطاعم وقص الشعر وما إلى ذلك |
PurchaseItemExtension
محتوى العنصر في قطاع الشراء
تمثيل JSON | |
---|---|
{ "status": enum ( |
الحقول | |
---|---|
status |
مطلوب: الحالة على مستوى العنصر. |
userVisibleStatusLabel |
مطلوب: تصنيف/سلسلة مرئية للمستخدم للحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا. |
type |
مطلوب: نوع الشراء |
productId |
معرّف المنتج أو العرض المرتبط بهذا العنصر. |
quantity |
كمية السلعة |
unitMeasure |
قياس الوحدة. تحدّد حجم السلعة في الوحدات المختارة. يتمّ استخدام المقاس والسعر النشط لتحديد سعر الوحدة. |
returnsInfo |
تعرض معلومات لهذا العنصر. في حال ترك هذه السياسة بدون ضبط، يكتسب هذا العنصر معلومات حول مستوى الطلب. |
fulfillmentInfo |
معلومات توصيل الطلب لهذا العنصر. في حال ترك هذه السياسة بدون ضبط، يكتسب هذا العنصر معلومات طريقة التنفيذ على مستوى الطلب. |
itemOptions[] |
العناصر الفرعية أو الإضافات الإضافية |
extension |
أي حقول إضافية يتم تبادلها بين التاجر وGoogle. كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
productDetails |
تفاصيل عن المنتج. |
MerchantUnitMeasure
مقياس تسعير وحدات التجّار
تمثيل JSON | |
---|---|
{
"measure": number,
"unit": enum ( |
الحقول | |
---|---|
measure |
القيمة: المثال 1.2. |
unit |
الوحدة: مثال على POUND وGRAM |
ItemOption
يمثل الإضافات أو العناصر الفرعية.
تمثيل JSON | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
الحقول | |
---|---|
id |
بالنسبة إلى خيارات العناصر، معرّف السلعة الفريد. |
name |
اسم الخيار. |
prices[] |
السعر الإجمالي للخيار. |
note |
ملاحظة ذات صلة بالخيار |
quantity |
بالنسبة إلى الخيارات التي تتمثل في العناصر والكمية. |
productId |
معرّف المنتج أو العرض المرتبط بهذا الخيار. |
subOptions[] |
لتحديد خيارات فرعية متداخلة أخرى. |
ProductDetails
تفاصيل عن المنتج.
تمثيل JSON | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
الحقول | |
---|---|
productId |
معرّف المنتج أو العرض المرتبط بهذا العنصر. |
gtin |
تمثّل هذه السمة الرقم التجاري العالمي للسلعة. يكون هذا الإجراء مفيدًا إذا لم يتوفّر معرّف العرض في Merchant Center. اختياريّ. |
plu |
رموز البحث عن الأسعار، والمعروفة عادةً برموز PLU، أو أرقام PLU، أو PLU، أو رموز المنتجات، أو ملصقات المنتجات، هي نظام من الأرقام التي تحدّد بشكل فريد المنتجات المجمّعة التي يتم بيعها في متاجر البقالة ومحلات السوبرماركت. |
productType |
فئة المنتج التي حدّدها التاجر. على سبيل المثال: "الصفحة الرئيسية > البقالة > منتجات الألبان والبيض > الحليب > الحليب الكامل" |
productAttributes |
التفاصيل التي يقدّمها التاجر حول المنتج، مثل { "allergen": "peanut" }. تكون هذه المعلومات مفيدة إذا لم يكن OfferId متوفّرًا في Merchant Center. اختياريّ. عنصر يحتوي على قائمة من أزواج |
ReservationItemExtension
محتويات البند الخاصة بالطلبات المحجوزة مثل المطعم وقص الشعر. رقم التعريف التالي: 15.
تمثيل JSON | |
---|---|
{ "status": enum ( |
الحقول | |
---|---|
status |
مطلوب: حالة الحجز. |
userVisibleStatusLabel |
مطلوب: تصنيف/سلسلة مرئية للمستخدم للحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا. |
type |
ونوع الحجز. يمكن إلغاء ضبط هذا الإعداد في حال عدم انطباق أي من خيارات النوع. |
reservationTime |
الوقت الذي تمت جدولة الخدمة/الحدث فيه. يمكن أن يتمثل في نطاق زمني أو تاريخ أو وقت محدّد. |
userAcceptableTimeRange |
نطاق زمني مقبول لدى المستخدم. |
confirmationCode |
رمز تأكيد هذا الحجز |
partySize |
عدد الأشخاص. |
staffFacilitators[] |
الموظفون المسؤولون عن الحجز. مثال مصفف الشعر. |
location |
الموقع الجغرافي للخدمة/الحدث |
extension |
أي حقول إضافية يتم تبادلها بين التاجر وGoogle. كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
StaffFacilitator
معلومات حول مقدِّم الخدمة.
تمثيل JSON | |
---|---|
{
"name": string,
"image": {
object ( |
الحقول | |
---|---|
name |
تمثّل هذه السمة اسم مُنسّق الموظفين. مثال "سَمِيرْ عَادِلْ" |
image |
صور المؤدي |