مسیر یک محموله را متعهد میکند که نشان میدهد در آینده نمیتوان آن را تغییر داد، حتی توسط کاربر، به استثنای موارد فورس ماژور/عمل خداوند که توسط روشهای وسایل نقلیه نشان داده شده است.makeUnavailable، hubs.makeUnavailable، lines.makeUnailable. این روش برای برچسب گذاری یک نسخه خاص از یک مسیر استفاده نمی شود.
درخواست HTTP
POST https://middlemileoptimization.googleapis.com/v1/{name=networks/*/shipments/*}/path:commit
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها | |
|---|---|
name | مورد نیاز. نام محموله ای که مسیر آن باید متعهد باشد. قالب: "شبکه/{شبکه}/محموله/{حمل و نقل}" |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{ // Union field |
| فیلدها | |
|---|---|
path_to_commit فیلد اتحادیه. مسیر یا قسمت هایی از مسیری که باید انجام شود. path_to_commit تنها می تواند یکی از موارد زیر باشد: | |
completeShipmentPath | بخش های یک مسیر از مبدا به مقصد. |
segments | زیرمجموعهای از بخشهای یک مسیر از مبدا به مقصد. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Path است.
PathToCommit
مسیر کامل در حال انجام، از مبدا تا مقصد.
| نمایندگی JSON |
|---|
{
"segments": [
{
object ( |
| فیلدها | |
|---|---|
segments[] | مورد نیاز. بخش ها باید به ترتیب باشند، از منبع تا مقصد. |
IncompletePathToCommit
بخشی از مسیر متعهد شده است، یعنی برخی از بخش های بین مبدا و مقصد.
| نمایندگی JSON |
|---|
{
"segments": [
{
object ( |
| فیلدها | |
|---|---|
segments[] | مورد نیاز. زیرمجموعهای از بخشهای یک مسیر از مبدا به مقصد. |