Order

موجودیت سفارش. توجه: 1. تمام رشته ها در تمام سطوح باید کمتر از 1000 کاراکتر باشند مگر اینکه طور دیگری مشخص شده باشد. 2. تعداد فیلدهای تکرار شده در تمام سطوح باید کمتر از 50 باشد، مگر اینکه طور دیگری مشخص شده باشد. 3. تمام مهرهای زمانی در همه سطوح، در صورت مشخص شدن، باید مهر زمانی معتبر باشند.

نمایندگی JSON
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
فیلدها
googleOrderId

string

Google شناسه سفارش را اختصاص داد.

merchantOrderId

string

مورد نیاز: شناسه سفارش داخلی به تاجر اختصاص داده شده است. این شناسه باید منحصر به فرد باشد و برای عملیات به روز رسانی بعدی سفارش لازم است. این شناسه ممکن است روی googleOrderId ارائه شده یا هر مقدار منحصر به فرد دیگری تنظیم شود. توجه داشته باشید که شناسه ارائه شده به کاربران userVisibleOrderId است که ممکن است مقداری متفاوت و کاربرپسندتر باشد. حداکثر طول مجاز 128 کاراکتر است.

userVisibleOrderId

string

کاربر با ارجاع شناسه به سفارش فعلی روبروست. این شناسه باید با شناسه نمایش داده شده برای این سفارش در زمینه‌های دیگر، از جمله وب‌سایت‌ها، برنامه‌ها و ایمیل مطابقت داشته باشد.

userVisibleStateLabel
(deprecated)

string

منسوخ شده: به جای آن از وضعیت OrderExtensions استفاده کنید. برچسب قابل مشاهده توسط کاربر برای وضعیت این سفارش.

buyerInfo

object ( UserInfo )

اطلاعات در مورد خریدار

image

object ( Image )

تصویر مرتبط با سفارش

createTime

string ( Timestamp format)

مورد نیاز: تاریخ و زمان ایجاد سفارش.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با دقت نانوثانیه. مثال: "2014-10-02T15:01:23.045123456Z" .

lastUpdateTime

string ( Timestamp format)

تاریخ و زمان آخرین به روز رسانی سفارش برای به روز رسانی سفارش مورد نیاز است.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با دقت نانوثانیه. مثال: "2014-10-02T15:01:23.045123456Z" .

transactionMerchant

object ( Merchant )

تاجری که تسویه حساب را تسهیل کرد. این می‌تواند با ارائه‌دهنده سطح مورد خطی متفاوت باشد. مثال: سفارش Expedia با مورد خط از ANA.

contents

object ( Contents )

مورد نیاز: محتویات را سفارش دهید که گروهی از موارد خطی است.

priceAttributes[]

object ( PriceAttribute )

قیمت، تخفیف، مالیات و غیره.

followUpActions[]

object ( Action )

پیگیری اقدامات در سطح سفارش

paymentData

object ( PaymentData )

داده های مربوط به پرداخت برای سفارش

termsOfServiceUrl

string

پیوندی به شرایط خدمات مربوط به سفارش/سفارش پیشنهادی.

note

string

یادداشت های پیوست شده به سفارش

promotions[]

object ( Promotion )

همه تبلیغاتی که با این سفارش مرتبط هستند.

disclosures[]

object ( Disclosure )

افشاهای مرتبط با این سفارش.

vertical
(deprecated)

object

منسوخ شده: به جای آن از عمودی استفاده کنید. این ویژگی ها برای همه موارد خط اعمال می شود، مگر اینکه در برخی از موارد خطی لغو شوند. این عمودی باید با نوع عمودی سطح مورد خط مطابقت داشته باشد. مقادیر ممکن: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .

verticals میدان اتحادیه این ویژگی ها برای همه موارد خط اعمال می شود، مگر اینکه در برخی از موارد خطی لغو شوند. این عمودی باید با نوع عمودی سطح مورد خط مطابقت داشته باشد. verticals فقط می توانند یکی از موارد زیر باشند:
purchase

object ( PurchaseOrderExtension )

سفارش خرید

ticket

object ( TicketOrderExtension )

سفارش بلیط

UserInfo

اطلاعات در مورد کاربر این برای نشان دادن اطلاعات کاربر مرتبط با یک سفارش استفاده می شود.

نمایندگی JSON
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
فیلدها
email

string

ایمیل کاربر، به عنوان مثال: janedoe@gmail.com .

firstName

string

نام کاربر.

lastName

string

نام خانوادگی کاربر.

displayName

string

نام نمایشی کاربر، ممکن است با نام یا نام خانوادگی متفاوت باشد.

phoneNumbers[]

object ( PhoneNumber )

شماره تلفن های کاربر

شماره تلفن

نمایندگی شماره تلفن استاندارد

نمایندگی JSON
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
فیلدها
e164PhoneNumber

string

شماره تلفن در قالب E.164، همانطور که در توصیه اتحادیه بین المللی مخابرات (ITU) E.164 تعریف شده است. پیوند ویکی: https://en.wikipedia.org/wiki/E.164

extension

string

برنامه افزودنی در توصیه های ITU استاندارد نشده است، به جز اینکه به عنوان مجموعه ای از اعداد با طول حداکثر 40 رقم تعریف شده است. در اینجا به‌عنوان رشته‌ای تعریف می‌شود که برای استفاده احتمالی از صفر اصلی در برنامه افزودنی استفاده می‌شود (سازمان‌ها آزادی کامل برای انجام این کار دارند، زیرا هیچ استانداردی تعریف نشده است). به غیر از ارقام، برخی از کاراکترهای شماره گیری دیگر مانند "," (که نشان دهنده انتظار است) ممکن است در اینجا ذخیره شوند. به عنوان مثال، در xxx-xxx-xxxx ext. 123، "123" پسوند است.

preferredDomesticCarrierCode

string

کد انتخاب شرکت مخابراتی که هنگام تماس با این شماره تلفن داخلی ترجیح داده می شود. این همچنین شامل کدهایی است که در برخی کشورها هنگام تماس از تلفن ثابت به تلفن همراه یا بالعکس باید شماره گیری شوند. به عنوان مثال، در کلمبیا، هنگام تماس از تلفن همراه به تلفن ثابت داخلی، یک "3" باید قبل از خود شماره تلفن شماره گیری شود. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

توجه داشته باشید که این کد "ترجیح" است، به این معنی که کدهای دیگر نیز ممکن است کار کنند.

تصویر

تصویری که در کارت نمایش داده می شود.

نمایندگی JSON
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
فیلدها
url

string

آدرس منبع تصویر تصاویر می توانند JPG، PNG و GIF (متحرک و غیر متحرک) باشند. برای مثال، https://www.agentx.com/logo.png . مورد نیاز.

accessibilityText

string

شرح متنی از تصویر که برای دسترسی استفاده می شود، به عنوان مثال صفحه خوان. مورد نیاز.

height

number

ارتفاع تصویر بر حسب پیکسل اختیاری.

width

number

عرض تصویر بر حسب پیکسل اختیاری.

بازرگان

تاجر برای سبد خرید/سفارش/خط مورد.

نمایندگی JSON
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
فیلدها
id

string

شناسه اختیاری به تاجر در صورت وجود اختصاص داده می‌شود.

name

string

نام تاجر مانند "نان پانرا".

image

object ( Image )

تصویر مرتبط با تاجر.

phoneNumbers[]

object ( PhoneNumber )

شماره تلفن های تاجر

address

object ( Location )

آدرس تاجر

مکان

ظرفی که نشان دهنده یک مکان است.

نمایندگی JSON
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
فیلدها
coordinates

object ( LatLng )

مختصات جغرافیایی به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] نیاز دارد.

formattedAddress

string

نشانی نمایش، به عنوان مثال، "1600 Amphitheatre Pkwy, Mountain View, CA 94043". به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] نیاز دارد.

zipCode

string

کد پستی به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] یا [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] نیاز دارد.

city

string

شهر. به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] یا [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] نیاز دارد.

postalAddress

object ( PostalAddress )

آدرس پستی به مجوز [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] یا [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] نیاز دارد.

name

string

نام مکان.

phoneNumber

string

شماره تلفن محل، به عنوان مثال شماره تماس محل کسب و کار یا شماره تلفن محل تحویل.

notes

string

نکاتی در مورد مکان

placeId

string

placeId با Places API برای واکشی جزئیات یک مکان استفاده می شود. به https://developers.google.com/places/web-service/place-id مراجعه کنید

LatLng

شیئی که نشان دهنده یک جفت طول و عرض جغرافیایی است. این به صورت یک جفت دوتایی بیان می شود که نشان دهنده درجه عرض جغرافیایی و درجه طول جغرافیایی است. مگر اینکه طور دیگری مشخص شده باشد، این باید با استاندارد WGS84 مطابقت داشته باشد. مقادیر باید در محدوده نرمال شده باشند.

نمایندگی JSON
{
  "latitude": number,
  "longitude": number
}
فیلدها
latitude

number

عرض جغرافیایی بر حسب درجه باید در محدوده [-90.0، +90.0] باشد.

longitude

number

طول جغرافیایی بر حسب درجه باید در محدوده [-180.0، +180.0] باشد.

آدرس پستی

نشان دهنده یک آدرس پستی است، به عنوان مثال برای آدرس های تحویل پستی یا پرداخت. با توجه به آدرس پستی، یک سرویس پستی می تواند اقلام را به محل، صندوق پستی یا موارد مشابه تحویل دهد. مدل سازی مکان های جغرافیایی (جاده ها، شهرها، کوه ها) در نظر گرفته نشده است.

در استفاده معمولی، بسته به نوع فرآیند، یک آدرس از طریق ورودی کاربر یا از وارد کردن داده‌های موجود ایجاد می‌شود.

توصیه‌هایی در مورد ورودی/ویرایش آدرس: - از ویجت آدرس آماده i18n مانند https://github.com/google/libaddressinput استفاده کنید - نباید عناصر رابط کاربری برای ورودی یا ویرایش فیلدها در خارج از کشورهایی که آن فیلد در آن وجود دارد، به کاربران ارائه شود. استفاده می شود.

برای راهنمایی بیشتر در مورد نحوه استفاده از این طرح، لطفاً به این آدرس مراجعه کنید: https://support.google.com/business/answer/6397478

نمایندگی JSON
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
فیلدها
revision

number

بازبینی طرحواره PostalAddress . این باید روی 0 تنظیم شود که آخرین ویرایش است.

همه ویرایش‌های جدید باید با نسخه‌های قبلی سازگار باشند.

regionCode

string

مورد نیاز. کد منطقه CLDR کشور/منطقه آدرس. این هرگز استنباط نمی شود و اطمینان از صحیح بودن مقدار به عهده کاربر است. برای جزئیات بیشتر به http://cldr.unicode.org/ و http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید. مثال: "CH" برای سوئیس.

languageCode

string

اختیاری. کد زبان BCP-47 محتویات این آدرس (در صورت شناخته شدن). این اغلب زبان رابط کاربری فرم ورودی است یا انتظار می‌رود با یکی از زبان‌های مورد استفاده در کشور/منطقه آدرس یا معادل‌های نویسه‌گردانی شده آنها مطابقت داشته باشد. این می‌تواند بر قالب‌بندی در برخی کشورها تأثیر بگذارد، اما برای صحت داده‌ها حیاتی نیست و هرگز بر روی اعتبارسنجی یا سایر عملیات مرتبط با قالب‌بندی تأثیر نمی‌گذارد.

اگر این مقدار مشخص نیست، باید حذف شود (به جای تعیین یک پیش فرض احتمالاً نادرست).

مثال: "zh-Hant"، "ja"، "ja-Latn"، "en".

postalCode

string

اختیاری. کد پستی آدرس همه کشورها از وجود کدهای پستی استفاده نمی‌کنند یا نیاز به وجود کد پستی ندارند، اما در جایی که از آنها استفاده می‌شود، ممکن است اعتبار سنجی اضافی را با سایر قسمت‌های آدرس (مثلاً اعتبارسنجی ایالت/زیپ در ایالات متحده آمریکا) ایجاد کنند.

sortingCode

string

اختیاری. کد مرتب‌سازی اضافی، خاص کشور. این در اکثر مناطق استفاده نمی شود. در جایی که از آن استفاده می‌شود، مقدار یا رشته‌ای مانند «CEDEX» است، که به صورت اختیاری با یک عدد دنبال می‌شود (مثلاً «CEDEX 7»)، یا فقط یک عدد به تنهایی، نشان‌دهنده «کد بخش» (جامائیکا)، «نشانگر ناحیه تحویل» است. (مالاوی) یا «نشانگر اداره پست» (مثلاً ساحل عاج).

administrativeArea

string

اختیاری. بالاترین بخش اداری که برای آدرس های پستی یک کشور یا منطقه استفاده می شود. به عنوان مثال، این می تواند یک ایالت، یک استان، یک استان یا یک استان باشد. به طور خاص، برای اسپانیا این استان است و نه جامعه خودمختار (مثلاً "بارسلونا" و نه "کاتالونیا"). بسیاری از کشورها از یک منطقه اداری در آدرس های پستی استفاده نمی کنند. به عنوان مثال در سوئیس این باید خالی از سکنه بماند.

locality

string

اختیاری. عموماً به بخش شهر/شهرک آدرس اشاره دارد. مثال: شهر ایالات متحده، کمون فناوری اطلاعات، شهر پست بریتانیا. در مناطقی از جهان که محلی ها به خوبی تعریف نشده اند یا به خوبی در این ساختار قرار نمی گیرند، محلی را خالی بگذارید و از خطوط آدرس استفاده کنید.

sublocality

string

اختیاری. موقعیت فرعی آدرس به عنوان مثال، این می تواند محله، محله، منطقه باشد.

addressLines[]

string

خطوط آدرس بدون ساختار که سطوح پایین یک آدرس را توصیف می کند.

از آنجایی که مقادیر در addressLines اطلاعات نوع ندارند و گاهی اوقات ممکن است حاوی چندین مقدار در یک فیلد واحد باشند (به عنوان مثال "Austin, TX")، واضح بودن ترتیب خطوط مهم است. ترتیب خطوط آدرس باید "سفارش پاکت" برای کشور/منطقه آدرس باشد. در جاهایی که ممکن است متفاوت باشد (مثلاً ژاپن)، address_language برای صریح‌تر کردن آن استفاده می‌شود (مثلاً "ja" برای سفارش بزرگ به کوچک و "ja-Latn" یا "en" برای کوچک به بزرگ). به این ترتیب، مشخص ترین خط یک آدرس را می توان بر اساس زبان انتخاب کرد.

حداقل نمایش ساختاری مجاز یک آدرس شامل یک RegionCode با تمام اطلاعات باقیمانده در خطوط آدرس است. قالب بندی چنین آدرسی تقریباً بدون کدگذاری جغرافیایی امکان پذیر است، اما هیچ استدلال معنایی در مورد هیچ یک از اجزای آدرس نمی توان تا حداقل تا حدی حل شود.

ایجاد آدرسی که فقط شامل یک regionCode و addressLines باشد و سپس geocoding روشی توصیه شده برای مدیریت آدرس‌های کاملاً بدون ساختار است (برخلاف حدس زدن اینکه کدام قسمت‌های آدرس باید محل‌ها یا مناطق اداری باشند).

recipients[]

string

اختیاری. گیرنده در آدرس این فیلد تحت شرایط خاصی ممکن است حاوی اطلاعات چند خطی باشد. به عنوان مثال، ممکن است حاوی اطلاعات "مراقبت از" باشد.

organization

string

اختیاری. نام سازمان در آدرس.

مطالب

لفاف برای اقلام خط.

نمایندگی JSON
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
فیلدها
lineItems[]

object ( LineItem )

لیست اقلام خط سفارش حداقل 1 مورد نیاز است و حداکثر 50 مورد مجاز است. همه موارد خط باید به یک عمود تعلق داشته باشند.

آیتم خط

یک مورد خطی شامل یک مورد عمودی است. یک سفارش یا سبد خرید می‌تواند چندین مورد خط عمودی مشابه داشته باشد. آیتم های فرعی/افزونه ها و غیره باید بسته به موارد استفاده در پروتوهای عمودی تعریف شوند. توجه: 1. تمام رشته ها در تمام سطوح باید کمتر از 1000 کاراکتر باشند مگر اینکه طور دیگری مشخص شده باشد. 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 Order با ارائه دهنده اقلام خطی 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 )

سفارشات رزرو مانند رستوران، مدل مو و غیره

قیمت ویژگی

ویژگی قیمت یک سفارش یا یک قلم خط.

نمایندگی JSON
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": number
  // End of list of possible types for union field spec.
}
فیلدها
type

enum ( Type )

مورد نیاز: نوع ویژگی پول.

name

string

مورد نیاز: رشته ای از ویژگی قیمت را کاربر نمایش می دهد. این توسط تاجر ارسال و بومی سازی شده است.

state

enum ( State )

مورد نیاز: وضعیت قیمت: برآورد در مقابل واقعی.

taxIncluded

boolean

این که آیا قیمت شامل مالیات می شود.

spec میدان اتحادیه نشان دهنده مقدار پولی یا درصد میلی است. spec می تواند تنها یکی از موارد زیر باشد:
amount

object ( Money )

مقدار پولی.

amountMillipercentage
(deprecated)

number

مشخصات درصد، به 1/1000 درصد. به عنوان مثال: 8.750٪ به عنوان 8750 نشان داده می شود، درصدهای منفی نشان دهنده درصد تخفیف هستند. منسوخ شدن این رشته می‌توانید در صورت نیاز به یک مورد استفاده مجدد، دوباره اضافه کنید.

تایپ کنید

نشان دهنده نوع پول است.

Enums
TYPE_UNSPECIFIED نوع نامشخص است، کلاینت ها نباید این را به صراحت تنظیم کنند.
REGULAR قیمت نمایش منظم، قبل از اعمال هرگونه تخفیف و غیره.
DISCOUNT از جمع فرعی کسر شود.
TAX به جمع فرعی اضافه می شود.
DELIVERY به جمع فرعی اضافه می شود.
SUBTOTAL جمع فرعی قبل از اضافه شدن برخی هزینه ها.
FEE هر گونه هزینه اضافی
GRATUITY به جمع فرعی اضافه می شود.
TOTAL قیمت سفارش یا خط مورد نمایش داده می شود.

ایالت

وضعیت قیمت را نشان می دهد.

Enums
STATE_UNSPECIFIED مشخص نشده است.
ESTIMATE قیمت فقط یک تخمین است.
ACTUAL قیمت واقعی که از کاربر دریافت خواهد شد.

پول

مقداری پول را با نوع ارز آن نشان می دهد.

نمایندگی JSON
{
  "currencyCode": string,
  "amountInMicros": string
}
فیلدها
currencyCode

string

کد ارز 3 حرفی تعریف شده در ISO 4217.

amountInMicros

string ( int64 format)

مقدار بر حسب میکرو به عنوان مثال، این فیلد باید به صورت 1990000 برای 1.99 دلار تنظیم شود.

اقدام

یک اقدام پیگیری مرتبط با سفارش یا مورد خط.

نمایندگی JSON
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
فیلدها
type

enum ( Type )

مورد نیاز: نوع عمل.

title

string

عنوان یا برچسب عمل، به کاربر نمایش داده می شود. حداکثر طول مجاز 100 کاراکتر است.

openUrlAction

object ( OpenUrlAction )

اقدام برای انجام.

actionMetadata

object ( ActionMetadata )

فراداده مرتبط با یک اقدام.

تایپ کنید

اقدامات بعدی احتمالی

Enums
TYPE_UNSPECIFIED اقدام نامشخص
VIEW_DETAILS عملکرد جزئیات سفارش را مشاهده کنید.
MODIFY عمل سفارش را اصلاح کنید.
CANCEL لغو اقدام سفارش
RETURN اقدام سفارش بازگشت
EXCHANGE اقدام سفارش مبادله.
EMAIL

اقدام ایمیل. انواع EMAIL و CALL منسوخ شده اند. openUrlAction.url می تواند به عنوان شماره تلفن یا ایمیل استفاده شود.

CALL

اقدام را فراخوانی کنید.

REORDER ترتیب مجدد اقدام.
REVIEW بررسی عملکرد سفارش
CUSTOMER_SERVICE با خدمات مشتری تماس بگیرید.
FIX_ISSUE برای رفع مشکل به سایت یا برنامه تاجر مراجعه کنید.
DIRECTION لینک جهت.

OpenUrlAction

url داده شده را باز می کند.

نمایندگی JSON
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
فیلدها
url

string

فیلد url که می تواند یکی از این موارد باشد: - آدرس های http/https برای باز کردن یک برنامه مرتبط با برنامه یا یک صفحه وب

androidApp

object ( AndroidApp )

اطلاعات مربوط به برنامه Android اگر انتظار می رود URL توسط یک برنامه Android تکمیل شود.

urlTypeHint

enum ( UrlTypeHint )

یک اشاره برای نوع URL را نشان می دهد.

برنامه اندروید

مشخصات برنامه Android برای محدودیت های اجرا

نمایندگی JSON
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
فیلدها
packageName

string

نام بسته هنگام تعیین Android Fulfillment نام بسته باید مشخص شود.

versions[]

object ( VersionFilter )

هنگامی که چندین فیلتر مشخص می شود، هر گونه تطبیق فیلتر برنامه را فعال می کند.

نسخه فیلتر

اگر نسخه/های خاصی از برنامه مورد نیاز است باید VersionFilter گنجانده شود.

نمایندگی JSON
{
  "minVersion": number,
  "maxVersion": number
}
فیلدها
minVersion

number

حداقل کد نسخه یا 0، شامل.

maxVersion

number

حداکثر کد نسخه، شامل. محدوده در نظر گرفته شده [minVersion:maxVersion] است. محدوده تهی دلالت بر هر نسخه ای دارد. مثال‌ها: برای تعیین یک نسخه از: [target_version:target_version] استفاده کنید. برای تعیین هر نسخه، minVersion و maxVersion را نامشخص بگذارید. برای تعیین تمام نسخه ها تا maxVersion، minVersion را نامشخص بگذارید. برای تعیین تمام نسخه‌ها از minVersion، maxVersion را نامشخص بگذارید.

UrlTypeHint

انواع مختلف راهنمایی url.

Enums
URL_TYPE_HINT_UNSPECIFIED نامشخص
AMP_CONTENT URL که مستقیماً به محتوای AMP یا یک URL متعارف اشاره می کند که از طریق <link rel="amphtml"> به محتوای AMP اشاره می کند.

ActionMetadata

فراداده مرتبط در هر اقدام.

نمایندگی JSON
{
  "expireTime": string
}
فیلدها
expireTime

string ( Timestamp format)

زمانی که این اقدام منقضی می شود.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با دقت نانوثانیه. مثال: "2014-10-02T15:01:23.045123456Z" .

افشای

افشای محصول، خدمات یا خط‌مشی که ممکن است به کاربر ارائه شود.

نمایندگی JSON
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
فیلدها
title

string

عنوان افشاگری مثال: "اطلاعات ایمنی".

disclosureText

object ( DisclosureText )

محتوای افشا. لینک های وب مجاز هستند.

presentationOptions

object ( DisclosurePresentationOptions )

گزینه های ارائه برای افشای.

DisclosureText

یک متن ساده را با پیوندهای وب نشان می دهد.

نمایندگی JSON
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
فیلدها
template

string

متنی برای نمایش، حاوی متغیرهایی مانند "{0}" و "{1}" برای هر پیوند نوشتاری که باید درج شود. مثال: "هشدار: این محصول می تواند شما را در معرض مواد شیمیایی قرار دهد که در ایالت کالیفرنیا به عنوان عامل سرطان شناخته شده است. برای اطلاعات بیشتر به {0} مراجعه کنید." این متن افشا نباید حاوی محتوای تبلیغاتی یا تبلیغاتی باشد.

DisclosurePresentationOptions

گزینه هایی برای ارائه یک افشا.

نمایندگی JSON
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
فیلدها
presentationRequirement

enum ( PresentationRequirement )

الزامات ارائه افشا.

initiallyExpanded

boolean

اینکه آیا محتوای افشا باید در ابتدا گسترش یابد یا خیر. به طور پیش فرض، در ابتدا جمع شده است.

الزامات ارائه

الزام برای ارائه افشا.

Enums
REQUIREMENT_UNSPECIFIED نیاز نامشخص نباید این را به صراحت تنظیم کرد.
REQUIREMENT_OPTIONAL افشای اختیاری است. اگر دستگاه از نمایش افشاگری پشتیبانی نمی کند، می توان از آن صرفنظر کرد.
REQUIREMENT_REQUIRED افشاء الزامی است. در صورتی که دستگاه از نمایش افشاگری پشتیبانی نکند، مکالمه به تلفن تبدیل خواهد شد.

PurchaseItem Extension

محتویات مورد خط خرید عمودی.

نمایندگی JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": number,
  "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

number

مقدار مورد.

unitMeasure

object ( MerchantUnitMeasure )

اندازه گیری واحد اندازه مورد را در واحدهای انتخابی مشخص می کند. اندازه به همراه قیمت فعال برای تعیین قیمت واحد استفاده می شود.

returnsInfo

object ( PurchaseReturnsInfo )

اطلاعات این مورد خطی را برمی‌گرداند. اگر تنظیم نشود، این مورد خطی اطلاعات سطح سفارش را به ارث می برد.

fulfillmentInfo

object ( PurchaseFulfillmentInfo )

اطلاعات تکمیلی برای این مورد خطی. اگر تنظیم نشود، این مورد خط اطلاعات تکمیل سطح سفارش را به ارث می برد.

itemOptions[]

object ( ItemOption )

افزونه ها یا موارد فرعی اضافی.

extension

object

هر فیلد اضافی رد و بدل شده بین تاجر و گوگل.

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .

productDetails

object ( ProductDetails )

جزئیات در مورد محصول.

وضعیت خرید

وضعیت خرید مرتبط با یک سفارش خرید یا یک مورد خط خاص.

Enums
PURCHASE_STATUS_UNSPECIFIED وضعیت نامشخص
READY_FOR_PICKUP آماده برای تحویل گرفتن
SHIPPED ارسال شد.
DELIVERED تحویل داده شد.
OUT_OF_STOCK موجود نیست.
IN_PREPARATION "IN_PREPARATION" می تواند در زمینه های مختلف معنای متفاوتی داشته باشد. برای سفارش غذا ممکن است غذا در حال آماده شدن باشد. برای خرده فروشی، ممکن است کالایی در حال بسته بندی باشد.
CREATED نظم ایجاد می شود.
CONFIRMED تاجر سفارش را تایید کرد.
REJECTED تاجر سفارش یا مورد خط را رد کرد.
RETURNED مورد توسط کاربر برگردانده شد.
CANCELLED سفارش یا مورد خط توسط کاربر لغو شد.
CHANGE_REQUESTED کاربر تغییر سفارش را درخواست کرده است و ادغام کننده در حال پردازش این تغییر است. پس از رسیدگی به درخواست، سفارش باید به حالت دیگری منتقل شود.

نوع خرید

دسته خرید.

Enums
PURCHASE_TYPE_UNSPECIFIED مقدار نامشخص
RETAIL این شامل خریدهایی مانند کالاهای فیزیکی است.
FOOD شامل خرید سفارش غذا می شود.
GROCERY خرید مواد غذایی.
MOBILE_RECHARGE خرید شارژ پیش پرداخت موبایل.

MerchantUnitMeasure

معیار قیمت گذاری واحد تجاری

نمایندگی JSON
{
  "measure": number,
  "unit": enum (Unit)
}
فیلدها
measure

number

مقدار: مثال 1.2.

unit

enum ( Unit )

واحد: مثال پوند، گرم.

واحد

Enums
UNIT_UNSPECIFIED واحد نامشخص
MILLIGRAM میلی گرم
GRAM گرم
KILOGRAM کیلو گرم
OUNCE اونس.
POUND پوند.

PurchaseReturnsInfo

اطلاعات مرتبط با یک سفارش یا یک خط خاص را برمی‌گرداند.

نمایندگی JSON
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
فیلدها
isReturnable

boolean

اگر درست باشد، بازگشت مجاز است.

daysToReturn

number

بازگشت در این چند روز مجاز است.

policyUrl

string

پیوند به سیاست بازگشت

PurchaseFulfillmentInfo

اطلاعات تکمیلی مرتبط با یک سفارش خرید یا یک مورد خط خاص.

نمایندگی JSON
{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
فیلدها
id

string

شناسه منحصر به فرد برای این گزینه سرویس.

fulfillmentType

enum ( Type )

مورد نیاز: نوع انجام.

expectedFulfillmentTime

object ( Time )

یک پنجره اگر یک بازه زمانی مشخص شده باشد یا ETA اگر یک زمان مشخص شده باشد. زمان مورد انتظار تحویل یا تحویل

expectedPreparationTime

object ( Time )

یک پنجره اگر یک بازه زمانی مشخص شده باشد یا ETA اگر یک زمان مشخص شده باشد. زمان مورد انتظار برای تهیه غذا ترجیحا یکباره

location

object ( Location )

محل تحویل یا تحویل

expireTime

string ( Timestamp format)

زمانی که در آن این گزینه تکمیل منقضی می شود.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با دقت نانوثانیه. مثال: "2014-10-02T15:01:23.045123456Z" .

price

object ( PriceAttribute )

هزینه این گزینه

fulfillmentContact

object ( UserInfo )

تماس کاربر برای این تحقق.

shippingMethodName

string

نام روش ارسال انتخاب شده توسط کاربر.

storeCode

string

کد فروشگاه محل. مثال: Walmart تاجر است و storeCode فروشگاه والمارت است که در آن تکمیل اتفاق افتاده است. https://support.google.com/business/answer/3370250?ref_topic=4596653 .

pickupInfo

object ( PickupInfo )

اطلاعات تکمیلی در مورد نحوه انتخاب سفارش این فیلد فقط زمانی قابل اعمال خواهد بود که نوع تکمیل، PICKUP باشد.

تایپ کنید

نوع تحقق.

Enums
TYPE_UNSPECIFIED تایپ نامشخص
DELIVERY این سفارش تحویل داده خواهد شد.
PICKUP این سفارش باید دریافت شود.

زمان

ساختار زمان برای نمایش زمان یک رویداد برای استفاده در هنگام نمایش سفارش به کاربر.

نمایندگی JSON
{
  "timeIso8601": string
}
فیلدها
timeIso8601

string

یک زمان سفارش-رویداد مانند زمان رزرو، زمان تحویل و غیره را نشان می دهد. ممکن است مدت زمان (زمان شروع و پایان)، فقط تاریخ، زمان تاریخ و غیره باشد. برای همه قالب‌های پشتیبانی شده به https://en.wikipedia.org/wiki/ISO_8601 مراجعه کنید.

اطلاعات پیکاپ

جزئیات در مورد نحوه دریافت سفارش این شامل جزئیاتی مانند نوع پیکاپ و ابرداده اضافی است که به هر نوع پیوست شده است، در صورت وجود.

نمایندگی JSON
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
فیلدها
pickupType

enum ( PickupType )

روش برداشت، مانند INSTORE، CURBSIDE و غیره.

curbsideInfo

object ( CurbsideInfo )

جزئیات مختص به اطلاعات حاشیه. اگر pickupType "CURBSIDE" نباشد، این فیلد نادیده گرفته می شود.

checkInInfo[]

object ( CheckInInfo )

فهرستی از روش‌های مختلف پشتیبانی شده توسط شریک برای پشتیبانی از ورود.

نوع پیکاپ

لیست انواع پیکاپ پشتیبانی شده

Enums
UNSPECIFIED نوع برداشت نامشخص
INSTORE غذا را از داخل رستوران بردارید.
CURBSIDE وسیله نقلیه را در یک نقطه مشخص خارج از رستوران پارک کنید و یک نفر غذا را در آنجا تحویل دهد.

CurbsideInfo

جزئیات در مورد چگونگی تسهیل سفارش در حاشیه.

نمایندگی JSON
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
فیلدها
curbsideFulfillmentType

enum ( CurbsideFulfillmentType )

شرکا به اطلاعات بیشتری برای تسهیل سفارش‌های وانت در کنار خیابان نیاز دارند. بسته به نوع اجرای انتخاب شده، جزئیات مربوطه از کاربر جمع آوری می شود.

userVehicle

object ( Vehicle )

مشخصات خودروی کاربر سفارش دهنده

CurbsideFulfillmentType

مقادیر احتمالی انواع تکمیل حاشیه.

Enums
UNSPECIFIED نوع اجرای کناری مشخص نشده است.
VEHICLE_DETAIL جزئیات وسیله نقلیه برای تسهیل وانت در کنار خیابان مورد نیاز است.

وسیله نقلیه

جزئیات در مورد یک وسیله نقلیه

نمایندگی JSON
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
فیلدها
make

string

ساخت خودرو (به عنوان مثال "هوندا"). این به کاربر نمایش داده می شود و باید محلی شود. مورد نیاز.

model

string

مدل خودرو (به عنوان مثال "Grom"). این به کاربر نمایش داده می شود و باید محلی شود. مورد نیاز.

licensePlate

string

شماره پلاک خودرو (به عنوان مثال "1ABC234"). مورد نیاز.

colorName

string

نام رنگ خودرو، به عنوان مثال. مشکی اختیاری

image

object ( Image )

آدرس یک عکس از خودرو. عکس تقریباً با ابعاد 256x256 پیکسل نمایش داده می شود. باید jpg یا png باشد. اختیاری.

CheckInInfo

فراداده مورد نیاز شریک برای پشتیبانی از روش اعلام حضور.

نمایندگی JSON
{
  "checkInType": enum (CheckInType)
}
فیلدها
checkInType

enum ( CheckInType )

روش مورد استفاده برای ارسال دستورالعمل های ورود.

CheckInType

روش های مختلفی برای ارسال دستورالعمل های ورود استفاده می شود.

Enums
CHECK_IN_TYPE_UNSPECIFIED مقدار نامشخص
EMAIL اطلاعات ثبت نام از طریق ایمیل ارسال می شود.
SMS اطلاعات ورود با پیامک ارسال می شود.

گزینه آیتم

نشان دهنده افزونه ها یا موارد فرعی است.

نمایندگی JSON
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
فیلدها
id

string

برای گزینه هایی که آیتم هستند، شناسه مورد منحصر به فرد.

name

string

نام گزینه.

prices[]

object ( PriceAttribute )

قیمت کل گزینه

note

string

یادداشت مربوط به گزینه

quantity

number

برای گزینه هایی که آیتم ها هستند، کمیت.

productId

string

شناسه محصول یا پیشنهاد مرتبط با این گزینه.

subOptions[]

object ( ItemOption )

برای تعریف دیگر گزینه های فرعی تو در تو.

جزئیات محصول

جزئیات در مورد محصول.

نمایندگی JSON
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
فیلدها
productId

string

شناسه محصول یا پیشنهاد مرتبط با این مورد خط.

gtin

string

شماره کالای تجارت جهانی محصول. اگر offerId در Merchant Center وجود نداشته باشد مفید است. اختیاری.

plu

string

کدهای جستجوی قیمت که معمولاً کدهای PLU، اعداد PLU، PLUs، کدهای تولید یا برچسب های تولید نامیده می شوند، سیستمی از اعداد هستند که محصولات فله ای را که در فروشگاه های مواد غذایی و سوپرمارکت ها فروخته می شوند به طور منحصر به فرد شناسایی می کنند.

productType

string

دسته بندی محصول توسط تاجر تعریف شده است. به عنوان مثال "خانه > مواد غذایی > لبنیات و تخم مرغ > شیر > شیر کامل"

productAttributes

map (key: string, value: string)

جزئیات ارائه شده توسط بازرگان در مورد محصول، به عنوان مثال { "allergen": "peanut" }. اگر offerId در Merchant Center وجود نداشته باشد مفید است. اختیاری.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

ReservationItem Extension

محتویات آیتم های خطی برای سفارش های رزرو مانند رستوران، مدل مو و غیره. شناسه بعدی: 15.

نمایندگی JSON
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": number,
  "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

number

تعداد افراد.

staffFacilitators[]

object ( StaffFacilitator )

کارکنان تسهیل کننده که رزرو را انجام خواهند داد. مثال آرایشگر.

location

object ( Location )

محل سرویس/رویداد.

extension

object

هر فیلد اضافی رد و بدل شده بین تاجر و گوگل.

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .

وضعیت رزرو

وضعیت رزرو.

Enums
RESERVATION_STATUS_UNSPECIFIED وضعیت نامشخص
PENDING رزرو در انتظار است.
CONFIRMED رزرو تایید شده است.
CANCELLED رزرو توسط کاربر لغو می شود.
FULFILLED رزرو انجام شده است.
CHANGE_REQUESTED تغییر رزرو درخواست می شود
REJECTED رزرو یا منقضی شده یا توسط ادغام کننده رد شده است.

نوع رزرو

نوع رزرو.

Enums
RESERVATION_TYPE_UNSPECIFIED نوع نامشخص
RESTAURANT رزرو برای رستوران.
HAIRDRESSER رزرو آرایشگاه.

کارکنان تسهیل کننده

اطلاعات در مورد مسئول خدمات.

نمایندگی JSON
{
  "name": string,
  "image": {
    object (Image)
  }
}
فیلدها
name

string

نام تسهیل کننده کارکنان. مثال "جان اسمیت"

image

object ( Image )

تصاویر مجری

داده های پرداخت

داده های پرداخت مربوط به یک سفارش.

نمایندگی JSON
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
فیلدها
paymentResult

object ( PaymentResult )

نتیجه پرداخت که توسط یکپارچه ساز برای تکمیل تراکنش استفاده می شود. اگر تجربه پرداخت توسط Actions-on-Google مدیریت شود، این قسمت توسط Actions on Google پر می‌شود.

paymentInfo

object ( PaymentInfo )

اطلاعات پرداخت مربوط به سفارش که برای تعامل با کاربر مفید است.

نتیجه پرداخت

نتیجه پرداخت که توسط یکپارچه ساز برای تکمیل تراکنش استفاده می شود.

نمایندگی JSON
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
فیلدها
result میدان اتحادیه داده‌های پرداخت Google یا روش پرداخت تاجر ارائه شده است. result می تواند تنها یکی از موارد زیر باشد:
googlePaymentData

string

Google داده‌های روش پرداخت را ارائه کرد. اگر پردازشگر پرداخت شما به عنوان پردازشگر پرداخت پشتیبانی شده توسط Google در اینجا فهرست شده است: https://developers.google.com/pay/api/ برای اطلاع از جزئیات بیشتر، از طریق پیوند به پردازشگر پرداخت خود بروید. در غیر این صورت، برای جزئیات بار به اسناد زیر مراجعه کنید. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

تاجر/عملی روش پرداختی را که کاربر انتخاب کرده است ارائه کرده است.

PaymentInfo

اطلاعات پرداخت در مورد سفارش در حال انجام. این پروتو اطلاعاتی را می گیرد که برای تعامل با کاربر مفید است.

نمایندگی JSON
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
فیلدها
paymentMethodDisplayInfo

object ( PaymentMethodDisplayInfo )

نمایش اطلاعات روش پرداخت مورد استفاده برای تراکنش.

paymentMethodProvenance

enum ( PaymentMethodProvenance )

منشأ روش پرداخت مورد استفاده برای معامله. کاربر ممکن است روش پرداخت یکسانی را در گوگل و تاجر ثبت کرده باشد.

PaymentMethodDisplayInfo

نتیجه پرداخت که توسط یکپارچه ساز برای تکمیل تراکنش استفاده می شود.

نمایندگی JSON
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
فیلدها
paymentType

enum ( PaymentType )

نوع پرداخت.

paymentMethodDisplayName

string

نام قابل مشاهده توسط کاربر روش پرداخت. به عنوان مثال، VISA **** 1234 Checking acct **** 5678

paymentMethodVoiceName

string

نام روش پرداخت که برای دستگاه‌های دستیار فقط صوتی به کاربر گفته می‌شود. به عنوان مثال، "ویزای پایانی به یک دو سه چهار" یا "چک حساب با پایان پنج شش هفت هشت". توجه: این رشته بهینه‌سازی شده صوتی است که به‌جای payMethodDisplayName برای دستگاه‌های دستیار فقط صوتی استفاده می‌شود. اگر این رشته تنظیم نشده باشد، در عوض payMethodDisplayName به کاربر گفته می شود.

نوع پرداخت

PaymentType نشان‌دهنده شکل پرداختی است که برای روش پرداخت ارائه‌شده توسط فروشنده استفاده می‌شود. Action همچنین باید یک نام نمایشی برای روش پرداخت ارائه دهد.

Enums
PAYMENT_TYPE_UNSPECIFIED نوع پرداخت نامشخص
PAYMENT_CARD کارت اعتباری / بدهی یا پیش پرداخت.
BANK روش پرداخت حساب بانکی است.
LOYALTY_PROGRAM روش پرداخت یک برنامه وفاداری است.
CASH روش پرداخت نقدی می باشد.
GIFT_CARD روش پرداخت کارت هدیه است.
WALLET کیف پول شخص ثالث یعنی پی پال

روش پرداخت

منشأ روش پرداخت مورد استفاده برای معامله را نشان می دهد.

Enums
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED منشأ نامشخص است.
PAYMENT_METHOD_PROVENANCE_GOOGLE منشأ گوگل است.
PAYMENT_METHOD_PROVENANCE_MERCHANT منشأ تاجر است.

ارتقاء

تبلیغات/پیشنهادهایی که به سبد خرید اضافه شدند.

نمایندگی JSON
{
  "coupon": string
}
فیلدها
coupon

string

الزامی: کد کوپن اعمال شده در این پیشنهاد.

PurchaseOrder Extension

پسوند سفارش برای خرید عمودی. این ویژگی‌ها برای همه موارد خط داخل سفارش قابل اعمال هستند، مگر اینکه در یک آیتم خطی لغو شوند.

نمایندگی JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
فیلدها
status

enum ( PurchaseStatus )

مورد نیاز: وضعیت کلی برای سفارش.

userVisibleStatusLabel

string

برچسب/رشته قابل مشاهده توسط کاربر برای وضعیت. حداکثر طول مجاز 50 کاراکتر است.

type

enum ( PurchaseType )

مورد نیاز: نوع خرید

returnsInfo

object ( PurchaseReturnsInfo )

اطلاعات مربوط به سفارش را برگردانید.

fulfillmentInfo

object ( PurchaseFulfillmentInfo )

اطلاعات تکمیلی برای سفارش

extension

object

هر فیلد اضافی رد و بدل شده بین تاجر و گوگل.

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .

purchaseLocationType

enum ( PurchaseLocationType )

محل خرید (در فروشگاه / آنلاین)

errors[]

object ( PurchaseError )

اختیاری: خطاهایی که به دلیل آن این سفارش رد شد.

PurchaseLocationType

نوع مکان خرید

Enums
UNSPECIFIED_LOCATION مقدار نامشخص
ONLINE_PURCHASE تمامی خریدهای آنلاین خریداری شده است.
INSTORE_PURCHASE تمامی خریدهای فروشگاهی

خطای خرید

خطاهایی که می توان سفارش خرید را به دلیل آن رد کرد.

نمایندگی JSON
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": number
}
فیلدها
type

enum ( ErrorType )

مورد نیاز: این نشان دهنده دلیل اصلی رد شدن سفارش توسط تاجر است.

description

string

توضیحات بیشتر خطا

entityId

string

شناسه نهاد که با خطا مطابقت دارد. به عنوان مثال این می تواند با LineItemId / ItemOptionId مطابقت داشته باشد.

updatedPrice

object ( PriceAttribute )

مربوط به نوع خطا PRICE_CHANGED / INCORRECT_PRICE.

availableQuantity

number

تعداد موجود در حال حاضر قابل اجرا در صورت AVAILABILITY_CHANGED.

نوع خطا

انواع خطاهای احتمالی

Enums
ERROR_TYPE_UNSPECIFIED خطای ناشناخته
NOT_FOUND موجودیت یافت نشد، می تواند مورد، FulfillmentOption، Promotion باشد. شناسه نهاد مورد نیاز است.
INVALID داده های موجودیت معتبر نیست. می تواند آیتم، گزینه تکمیل، ارتقاء باشد. شناسه نهاد مورد نیاز است.
AVAILABILITY_CHANGED مورد در دسترس نیست یا موارد کافی برای انجام درخواست وجود ندارد. شناسه نهاد مورد نیاز است.
PRICE_CHANGED قیمت مورد با قیمت موجود در مورد متفاوت است. شناسه نهاد و قیمت به روز مورد نیاز است.
INCORRECT_PRICE خطاهای قیمت در هزینه ها، مجموع. شناسه نهاد و قیمت به روز مورد نیاز است.
REQUIREMENTS_NOT_MET محدودیت‌های پذیرش سفارش رعایت نشده است - حداقل اندازه سبد و غیره.
TOO_LATE FulfillmentOption منقضی شده است.
NO_CAPACITY ظرفیت سرویس در دسترس نیست.
INELIGIBLE کاربر واجد شرایط برای ثبت سفارش (در لیست سیاه).
OUT_OF_SERVICE_AREA به دلیل قوانین مرزی و غیره امکان تحویل به آدرس درخواستی وجود ندارد.
CLOSED رستوران در زمان سفارش برای کار بسته است.
PROMO_NOT_APPLICABLE کد خطای عمومی برای دریافت همه موارد عدم استفاده از کد تبلیغاتی، در صورتی که هیچ یک از موارد زیر مناسب نباشد. کد تبلیغاتی را به عنوان شناسه نهاد اضافه کنید.
PROMO_NOT_RECOGNIZED کد کوپن توسط شریک شناسایی نشد. کد تبلیغاتی را به عنوان شناسه نهاد اضافه کنید.
PROMO_EXPIRED نمی توان اعمال کرد زیرا تبلیغات منقضی شده است. کد تبلیغاتی را به عنوان شناسه نهاد اضافه کنید.
PROMO_USER_INELIGIBLE کاربر فعلی واجد شرایط این کوپن نیست. کد تبلیغاتی را به عنوان شناسه نهاد اضافه کنید.
PROMO_ORDER_INELIGIBLE سفارش فعلی واجد شرایط این کوپن نیست. کد تبلیغاتی را به عنوان شناسه نهاد اضافه کنید.
UNAVAILABLE_SLOT اسلات سفارش پیش رو در دسترس نیست.
FAILED_PRECONDITION محدودیت‌های پذیرش سفارش رعایت نشده است - حداقل اندازه سبد و غیره
PAYMENT_DECLINED پرداخت نامعتبر
MERCHANT_UNREACHABLE تاجر قابل دسترسی نیست. این به زمانی کمک می کند که یک شریک جمع کننده باشد و نتواند به تاجر برسد.

TicketOrder Extension

سفارش محتویات برای سفارش بلیط مانند فیلم، ورزش و غیره.

نمایندگی JSON
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
فیلدها
ticketEvent

object ( TicketEvent )

این رویداد برای همه بلیت‌های مورد خط اعمال شد.

TicketEvent

یک رویداد واحد را نشان می دهد.

نمایندگی JSON
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
فیلدها
type

enum ( Type )

مورد نیاز: نوع رویداد بلیط، به عنوان مثال فیلم، کنسرت.

name

string

مورد نیاز: نام رویداد. به عنوان مثال، اگر رویداد یک فیلم است، این باید نام فیلم باشد.

description

string

شرح رویداد.

url

string

آدرس اینترنتی اطلاعات رویداد.

location

object ( Location )

مکانی که رویداد در آن رخ می دهد، یا یک سازمان در آن واقع شده است.

eventCharacters[]

object ( EventCharacter )

شخصیت های مرتبط با این رویداد. این می تواند کارگردان یا بازیگر یک رویداد سینمایی یا مجری یک کنسرت و غیره باشد.

startDate

object ( Time )

زمان شروع

endDate

object ( Time )

زمان پایان.

doorTime

object ( Time )

زمان ورود، که ممکن است با زمان شروع رویداد متفاوت باشد. به عنوان مثال رویداد از ساعت 9 صبح شروع می شود، اما زمان ورود 8:30 صبح است.

تایپ کنید

نوع رویداد.

Enums
EVENT_TYPE_UNKNOWN نوع رویداد ناشناخته
MOVIE فیلم.
CONCERT کنسرت.
SPORTS ورزش.

شخصیت رویداد

یک شخصیت رویداد، به عنوان مثال سازمان دهنده، مجری و غیره.

نمایندگی JSON
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
فیلدها
type

enum ( Type )

نوع شخصیت رویداد، به عنوان مثال بازیگر یا کارگردان.

name

string

نام شخصیت.

image

object ( Image )

تصاویر شخصیت

تایپ کنید

نوع کاراکتر.

Enums
TYPE_UNKNOWN نوع ناشناخته
ACTOR بازیگر.
PERFORMER مجری.
DIRECTOR کارگردان.
ORGANIZER سازمان دهنده.