با استفاده از یک توکن سفارشی که توسط گوگل ساخته شده است، سفارش جدید را ایجاد و برمی گرداند. توسعه دهندگانی که از این روش استفاده می کنند باید userToken ارسال شده توسط گوگل را در درخواست تنظیم کنند. این روش در مواردی استفاده میشود که توسعهدهندگان/تجار مستقیماً سفارشها را از طرف سفارش در Google ذخیره میکنند (بهجای تراکنشها و جریان AMP).
درخواست HTTP
POST https://actions.googleapis.com/v3/orders:createWithCustomToken
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON | |
---|---|
{ "header": { object ( |
فیلدها | |
---|---|
header | مورد نیاز: سربرگ درخواست سفارش ایجاد. |
order | مورد نیاز: سفارش ایجاد شود. توجه: 1. برای ایجاد یک سفارش معتبر، همیشه فیلدهای زیر مورد نیاز است: order.create_time، order.merchant_order_id، order.contents.line_items، order.contents.line_items.id 2. سفارش باید حداقل 1 مورد و خط داشته باشد. باید عمودی/پسوند تعریف شده باشد. 3. همه پسوندها (هم در سطح سفارش و هم در سطح خط_آیتم) باید به 1 نوع عمودی نگاشت شوند. یک سفارش اگر بیش از 1 عمودی را نشان دهد، یک سفارش معتبر نیست. |
userToken | مورد نیاز: رمز رمزگذاری شده توسط Google از طریق کانال ناهمزمان به شریک ارائه شده است. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Order
است.