- ייצוג JSON
- תוכן עניינים
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- מבצע
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
ישות ההזמנה. הערה: 1. כל המחרוזות בכל הרמות חייבות להיות באורך של פחות מ-1,000 תווים, אלא אם צוין אחרת. 2. כל השדות החוזרים בכל הרמות חייבים להיות קטנים מ-50, אלא אם צוין אחרת. 3. אם מציינים את כל חותמות הזמן בכל הרמות, הן חייבות להיות חותמות זמן תקינות.
ייצוג JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
שדות | ||
---|---|---|
googleOrderId |
מזהה ההזמנה שהוקצה על ידי Google. |
|
merchantOrderId |
חובה: מזהה הזמנה פנימי שהוקצה על ידי המוכר. המזהה הזה צריך להיות ייחודי, והוא נדרש לפעולות הבאות של עדכון הזמנה. אפשר להגדיר את המזהה הזה ל-googleOrderId שצוין או לכל ערך ייחודי אחר. שימו לב שהמזהה שמוצג למשתמשים הוא uservisibleOrderId, שעשוי להיות ערך שונה וידידותי יותר למשתמש. האורך המקסימלי המותר הוא 128 תווים. |
|
userVisibleOrderId |
המזהה שגלוי למשתמש שמתייחס להזמנה הנוכחית. המזהה הזה צריך להיות תואם למזהה שמוצג בהזמנה הזו בהקשרים אחרים, כולל אתרים, אפליקציות ואימייל. |
|
userVisibleStateLabel |
הוצא משימוש: יש להשתמש בסטטוס של תוספי הזמנה. תווית גלויה למשתמש של מצב ההזמנה הזו. |
|
buyerInfo |
מידע על הקונה. |
|
image |
תמונה שמשויכת להזמנה. |
|
createTime |
חובה: התאריך והשעה שבהם ההזמנה נוצרה. חותמת זמן בפורמט "זולו" RFC3339 UTC, מדויקת לננו-שניות. דוגמה: |
|
lastUpdateTime |
התאריך והשעה שבהם ההזמנה עודכנה לאחרונה. נדרש עבור OrderUpdate. חותמת זמן בפורמט "זולו" RFC3339 UTC, מדויקת לננו-שניות. דוגמה: |
|
transactionMerchant |
המוכר שאפשר את התשלום בקופה. הספק יכול להיות שונה מספק ברמת הפריט. דוגמה: הזמנת Expedia עם פריט מ-ANA. |
|
contents |
נדרש: תוכן ההזמנה שהוא קבוצה של פריטים. |
|
priceAttributes[] |
מחיר, הנחות, מיסים וכו'. |
|
followUpActions[] |
פעולות מעקב ברמת ההזמנה. |
|
paymentData |
נתונים שקשורים לתשלום של ההזמנה. |
|
termsOfServiceUrl |
קישור לתנאים ולהגבלות שחלים על הזמנה/הזמנה מוצעת. |
|
note |
הערות המצורפות להזמנה. |
|
promotions[] |
כל קידומי המכירות המשויכים להזמנה הזו. |
|
disclosures[] |
הודעות גילוי נאות המשויכות להזמנה הזו. |
|
vertical |
הוצא משימוש: יש להשתמש בעמודות במקום זאת. המאפיינים האלה יחולו על כל הפריטים, אלא אם הם יבוטלו בפריט מסוים. הקטגוריה הזו חייבת להתאים לסוג האנכי ברמת הפריט. ערכים אפשריים: אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
|
שדה איחוד verticals . המאפיינים האלה יחולו על כל הפריטים, אלא אם הם יבוטלו בפריט מסוים. הקטגוריה הזו חייבת להתאים לסוג האנכי ברמת הפריט. הערך של verticals יכול להיות רק אחת מהאפשרויות הבאות: |
||
purchase |
הזמנת רכש |
|
ticket |
הזמנת כרטיסים |
תוכן עניינים
ראפ לפריטים.
ייצוג JSON | |
---|---|
{
"lineItems": [
{
object ( |
שדות | |
---|---|
lineItems[] |
רשימת הפריטים בהזמנה. יש לציין פריט שורה אחד לפחות, ואפשר להזין עד 50 פריטים. כל הפריטים חייבים להשתייך לאותה תעשייה. |
PaymentData
נתוני תשלום שקשורים להזמנה.
ייצוג JSON | |
---|---|
{ "paymentResult": { object ( |
שדות | |
---|---|
paymentResult |
תוצאת תשלום המשמשת את השילוב להשלמת עסקה. השדה הזה יאוכלס בפעולות ב-Google אם חוויית התשלום מנוהלת על ידי actions-on-Google. |
paymentInfo |
פרטי תשלום בנוגע להזמנה שעוזרים לאינטראקציה מול המשתמש. |
PaymentResult
תוצאת תשלום המשמשת את השילוב להשלמת עסקה.
ייצוג JSON | |
---|---|
{ // Union field |
שדות | ||
---|---|---|
שדה איחוד result . סיפקת נתוני תשלום מ-Google או אמצעי תשלום של מוכר. הערך של result יכול להיות רק אחת מהאפשרויות הבאות: |
||
googlePaymentData |
נתונים של אמצעי התשלום ש-Google סיפקה. אם ספק שירותי התשלומים שלכם רשום בתור ספק שירותי התשלומים הנתמך על ידי Google: https://developers.google.com/pay/api/, ניתן לעבור אל ספק שירותי התשלומים שלכם באמצעות הקישור כדי לקבל פרטים נוספים. אם לא, כדאי לעיין במסמכים הבאים בנושא פרטי מטען ייעודי (payload). https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
אמצעי התשלום שסופק על ידי המוכר או הפעולה שנבחרה על ידי המשתמש. |
PaymentInfo
פרטי התשלום בנוגע להזמנה שבוצעה. הפרוטו הזה לוכד מידע שימושי לאינטראקציה מול המשתמש.
ייצוג JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
שדות | |
---|---|
paymentMethodDisplayInfo |
פרטי אמצעי התשלום ששימש לביצוע העסקה. |
paymentMethodProvenance |
המקור של אמצעי התשלום ששימש לעסקה. יכול להיות שהמשתמש רשם את אותו אמצעי תשלום גם ב-Google וגם במוכר. |
PaymentMethodDisplayInfo
תוצאת תשלום המשמשת את השילוב להשלמת עסקה.
ייצוג JSON | |
---|---|
{
"paymentType": enum ( |
שדות | |
---|---|
paymentType |
סוג התשלום. |
paymentMethodDisplayName |
השם של אמצעי התשלום שגלוי למשתמש. לדוגמה, VISA **** 1234 חשבון עו"ש **** 5678 |
תוכן מקודם
מבצעים/מבצעים שנוספו לעגלת הקניות.
ייצוג JSON | |
---|---|
{ "coupon": string } |
שדות | |
---|---|
coupon |
חובה: קוד השובר מומש על המבצע הזה. |
PurchaseOrderExtension
תוסף הזמנה לקטגוריית הרכישה. המאפיינים האלה רלוונטיים לכל הפריטים שנכללים בהזמנה, אלא אם הם בוטלו בפריט כלשהו.
ייצוג JSON | |
---|---|
{ "status": enum ( |
שדות | |
---|---|
status |
חובה: סטטוס כללי של ההזמנה. |
userVisibleStatusLabel |
תווית/מחרוזת גלויים למשתמש עבור הסטטוס. האורך המקסימלי המותר הוא 50 תווים. |
type |
חובה: סוג הרכישה. |
returnsInfo |
החזרת פרטי ההזמנה. |
fulfillmentInfo |
פרטי אספקה של ההזמנה. |
extension |
כל השדות הנוספים שיועברו בין המוכר ל-Google. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
purchaseLocationType |
מיקום הרכישה (בחנות / באינטרנט) |
errors[] |
אופציונלי: שגיאות שגרמו לדחייה של ההזמנה. |
PurchaseError
שגיאות שגורמות לדחייה של הזמנת רכש.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
חובה: הערך הזה מייצג את הסיבה המפורטת שבגללה המוכר דחה הזמנה. |
description |
תיאור שגיאה נוסף. |
entityId |
מזהה הישות שתואם לשגיאה. לדוגמה, ערך זה יכול להתאים לערך LineItemId / ItemOptionId. |
updatedPrice |
רלוונטי במקרה של סוג שגיאה PRICE_Change / INCORRECT_PRICE. |
availableQuantity |
הכמות הזמינה עכשיו. רלוונטי במקרה של AVAILABILITY_מדה. |
TicketOrderExtension
הזמנת תכנים של הזמנות כרטיסים, כמו סרטים, ספורט וכו'.
ייצוג JSON | |
---|---|
{
"ticketEvent": {
object ( |
שדות | |
---|---|
ticketEvent |
האירוע הוחל על כל הכרטיסים של הפריטים. |
TicketEvent
מייצג אירוע יחיד.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
חובה: סוג האירוע בכרטיס, למשל סרט או הופעה. |
name |
חובה: שם האירוע. לדוגמה, אם האירוע הוא סרט, השם צריך להיות שם הסרט. |
description |
לתיאור האירוע. |
url |
כתובת ה-URL של פרטי האירוע. |
location |
המיקום שבו האירוע מתרחש או שבו ממוקם הארגון. |
eventCharacters[] |
התווים הקשורים לאירוע הזה. הוא יכול להיות במאי או שחקנים באירוע קולנוע, מבצעי קונצרטים וכו'. |
startDate |
שעת התחלה. |
endDate |
שעת סיום. |
doorTime |
שעת הכניסה, שעשויה להיות שונה משעת ההתחלה של האירוע. למשל, האירוע מתחיל ב-9:00 אבל שעת הכניסה היא 8:30. |
EventCharacter
דמות אחת באירוע, למשל מארגן, אמן וכו'.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
הסוג של דמות האירוע, למשל שחקן או במאי. |
name |
את שם הדמות. |
image |
תמונות של הדמות. |