LineItem

פריט אחד מכיל אנכי אחד. הזמנה או עגלה יכולים לכלול מספר פריטים באותה תעשייה. יש להגדיר פריטי משנה/תוספות וכו' בפרוטוקולים אנכיים בהתאם לתרחישי השימוש שלהם. הערה: 1. כל המחרוזות בכל הרמות חייבות להיות באורך של פחות מ-1,000 תווים, אלא אם צוין אחרת. 2. כל השדות החוזרים בכל הרמות חייבים להיות קטנים מ-50, אלא אם צוין אחרת. 3. אם מציינים את כל חותמות הזמן בכל הרמות, הן חייבות להיות חותמות זמן תקינות.

ייצוג JSON 
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
שדות
id

string

חובה: מזהה שהוקצה על ידי המוכר לפריט. משמש לזיהוי פריט קיים בהחלת עדכונים חלקיים. האורך המקסימלי המותר הוא 64 תווים.
name

string

שם הפריט כפי שמוצג בקבלה. האורך המקסימלי המותר הוא 100 תווים.
userVisibleStateLabel
(deprecated)

string

הוּצא משימוש. במקום זאת, אפשר להשתמש בסטטוס ברמה אנכית. לדוגמה, עבור רכישות, השתמש ב-PurchaseOrderExtension.status. תווית מצב גלויה למשתמש של מצב הפריט.
provider

object (Merchant)

הספק של הפריט המסוים, אם הוא שונה מההזמנה הכוללת. לדוגמה: הזמנה ב-Expedia עם ספק הפריטים ANA.
priceAttributes[]

object (PriceAttribute)

המחיר וההתאמות ברמת הפריט.
followUpActions[]

object (Action)

פעולות המשך בפריט.
recipients[]

object (UserInfo)

לקוחות ברמת הפריט, ייתכן שזה יהיה שונה מהקונה ברמת ההזמנה. דוגמה: משתמש X ביצע הזמנה במסעדה בשם משתמש Y.
image

object (Image)

תמונה קטנה שמשויכת לפריט הזה, אם יש כזה.
description

string

תיאור הפריט.
notes[]

string

הערות נוספות שרלוונטיות לפריט הספציפי הזה, לדוגמה, מדיניות הביטולים.
disclosures[]

object (Disclosure)

הודעות גילוי נאות המשויכות לפריט הזה.
vertical
(deprecated)

object

הוצא משימוש: יש להשתמש בעמודות במקום זאת. חובה: התוכן הסמנטי של הפריט על סמך הסוג או הקטגוריה שלו. כל קטגוריה צריכה לכלול פרטים משלה על מילוי הזמנות. חייב להיות אחד מהערכים הבאים: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI שמזהה את הסוג. דוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }
שדה איחוד verticals. חובה: התוכן הסמנטי של הפריט על סמך הסוג או הקטגוריה שלו. כל קטגוריה צריכה לכלול פרטים משלה על מילוי הזמנות. הערך של verticals יכול להיות רק אחת מהאפשרויות הבאות:
purchase

object (PurchaseItemExtension)

הזמנות רכש כמו מוצרים, אוכל וכו'
reservation

object (ReservationItemExtension)

הזמנות מקום כמו מסעדה, תספורת וכו'

PurchaseItemExtension

תוכן הפריט בקטגוריית הרכישה.

ייצוג JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
שדות
status

enum (PurchaseStatus)

נדרש: סטטוס ברמת הפריט.
userVisibleStatusLabel

string

חובה: תווית/מחרוזת גלויים למשתמש לסטטוס. האורך המקסימלי המותר הוא 50 תווים.
type

enum (PurchaseType)

חובה: סוג הרכישה.
productId
(deprecated)

string

מזהה המוצר או המבצע שמשויך לפריט הזה.
quantity

integer

כמות הפריט.
unitMeasure

object (MerchantUnitMeasure)

מידת יחידה. מאפיין זה מציין את גודל הפריט ביחידות שנבחרו. המחיר ליחידה, ביחד עם המחיר הפעיל, משמש לקביעת המחיר.
returnsInfo

object (PurchaseReturnsInfo)

מחזירה מידע על הפריט הזה. אם המדיניות לא מוגדרת, הפריט הזה יורש את רמת ההזמנה ומחזירה מידע.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

פרטי האספקה של הפריט הזה. אם המדיניות לא מוגדרת, הפריט הזה יורש את פרטי האספקה ברמת ההזמנה.
itemOptions[]

object (ItemOption)

תוספים או פריטי משנה נוספים.
extension

object

כל השדות הנוספים שיועברו בין המוכר ל-Google.

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI שמזהה את הסוג. דוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }
productDetails

object (ProductDetails)

פרטים על המוצר.

MerchantUnitMeasure

מידת תמחור יחידה של המוכר.

ייצוג JSON 
{
  "measure": number,
  "unit": enum (Unit)
}
שדות
measure

number

ערך: דוגמה 1.2.
unit

enum (Unit)

יחידה: דוגמה ל-POUND, GRAM.

ItemOption

מייצג תוספים או פריטי משנה.

ייצוג JSON 
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
שדות
id

string

לאפשרויות שהן פריטים, מזהה פריט ייחודי.
name

string

שם האפשרות.
prices[]

object (PriceAttribute)

המחיר הכולל של האופציה.
note

string

הערה שקשורה לאפשרות.
quantity

integer

לאפשרויות שהן פריטים, quantity.
productId

string

מזהה המוצר או המבצע שמשויך לאפשרות הזו.
subOptions[]

object (ItemOption)

כדי להגדיר אפשרויות משנה אחרות בתוך רכיב.

ProductDetails

פרטים על המוצר.

ייצוג JSON 
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
שדות
productId

string

מזהה המוצר או המבצע שמשויך לפריט הזה.
gtin

string

מספר הפריט המסחרי הגלובלי של המוצר. שימושי אם OfferId לא קיים ב-Merchant Center. אפשרות.
plu

string

קודים לחיפוש מחירים, שנקראים בדרך כלל קודי PLU, מספרי PLU, PLU, קודים לייצור או תוויות לתוצרת חקלאית, הם מערכת של מספרים שמזהים באופן ייחודי את התוצרת החקלאית שנמכרה בחנויות מכולת ובסופרמרקטים.
productType

string

קטגוריית המוצר שהוגדרה על ידי המוֹכר. למשל, "Home > מכולת > חלב וביצים > חלב > חלב מלא"
productAttributes

map (key: string, value: string)

פרטים שהמוכר סיפק לגבי המוצר, למשל { "allergen": "peanut" }. שימושי אם OfferId לא נמצא ב-Merchant Center. אפשרות.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }

ReservationItemExtension

תוכן של פריטים בהזמנות בהזמנה כמו מסעדה, תספורת וכו'. המזהה הבא: 15.

ייצוג JSON 
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
שדות
status

enum (ReservationStatus)

חובה: סטטוס הזמנה.
userVisibleStatusLabel

string

חובה: תווית/מחרוזת גלויים למשתמש לסטטוס. האורך המקסימלי המותר הוא 50 תווים.
type

enum (ReservationType)

סוג ההזמנה. אפשר לבטל את ההגדרה אם אף אחת מאפשרויות הסוגים לא רלוונטית.
reservationTime

object (Time)

השעה שבה השירות/האירוע מתוזמנים להתרחש. יכול להיות טווח זמן, תאריך או שעה מדויקת.
userAcceptableTimeRange

object (Time)

טווח הזמן המקובל על המשתמש.
confirmationCode

string

קוד האישור של ההזמנה הזו.
partySize

integer

מספר האנשים.
staffFacilitators[]

object (StaffFacilitator)

מנהלי צוות שיטפלו בהזמנה. דוגמה: מעצב השיער.
location

object (Location)

מיקום השירות או האירוע.
extension

object

כל השדות הנוספים שיועברו בין המוכר ל-Google.

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI שמזהה את הסוג. דוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }

StaffFacilitator

מידע על איש השירות.

ייצוג JSON 
{
  "name": string,
  "image": {
    object (Image)
  }
}
שדות
name

string

השם של מנחה הצוות. דוגמה: "ישראל ישראלי"
image

object (Image)

התמונות של האומן.