¶ Uber Direct とは？

Uber Direct は、販売業者がオンデマンド（ASAP、すぐに配達）と予約配達のサービスを提供できるようサポートします。これを実現するため、Uber は効果的な配達管理をサポートし、販売業者が自社固有の要件に合わせて配達オプションをカスタマイズできるようにするさまざまな機能を活用しています。Uber Direct を活用すると、Uber の配達パートナーをピックアップと配達に割り当てるプロセスを簡単に自動化できます。

¶ レート制限はありますか？

本番環境では、レート制限はエンドポイントによって異なります。特定の期間に許可されたリクエストの数を超過した場合は、429 customer_limited の応答が返されます。

サンドボックス環境では、レート制限は application_id ごとに適用されます。これは 10 分あたり 200 件のリクエストに設定されています。

意図的な利用シナリオによりレート制限に達した場合は、アカウントマネージャーにサポートを依頼してください。

¶ 「注文者 ID」、「クライアント ID」、「クライアントシークレット」の違いは何ですか？

「クライアント ID」と「クライアントシークレット」はアカウント全体で一貫しており、すべての組織、注文者 ID、場所に適用されます。ただし、API で使用される注文者 ID は、設定された組織体制によって異なる点に留意してください。運用フェーズに入る前に、アカウントマネージャーか Uber Direct の担当窓口と十分に議論して最終決定することが必要です。

¶ 生成された見積もりと quote_id はどのくらいの時間有効ですか？

15 分間です。

¶ 配達ステータスの Webhook と配達パートナーの最新情報に関する Webhook の違いは何ですか？

• 配達ステータスの Webhook：courier_imminent の変更など、配達の特定の段階でトリガーされる静的 Webhook です。詳細については「配達ステータスの Webhook」を参照してください。

• 配達パートナーの最新情報に関する Webhook：20 秒ごとに実行される動的 Webhook で、配達パートナーの位置情報に関する最新の座標を提供します。詳細については「配達パートナーの最新情報に関する Webhook」を参照してください。

どちらの Webhook についても、courier_imminent = true は配達パートナーがピックアップまたは受け渡しの場所から約 80 メートル以内にいることを示しています。

¶ 住所に関するベストプラクティスは何ですか？

• 構造化された住所と構造化されていない住所
  Uber のプラットフォームでは、構造化された住所と構造化されていない住所の 2 種類の形式に対応しています。どちらの形式も利用できますが、配達プロセスにおける正確性と妥当性を向上するためにも、構造化された住所形式を活用することを強くお勧めします。建物名や部屋番号は、住所構造の番地とは別の値として入力してください。

  構造化された住所：

  {
    "dropoff_address": "{\"street_address\":[\"1515 3rd St\",\"Apt. 5\"],\"city\":\"San Francisco\",\"state\":\"CA\",\"zip_code\":\"94158\",\"country\":\"US\"}"
  }
  

  構造化されていない住所：

  {
    "dropoff_address": "1515 3rd St, San Francisco, CA 94158"
  }
  

• 緯度と経度
  Uber に対するすべてのリクエストには、有効で正確な経度と緯度を含めることをお勧めします。
  重要：デフォルトでは、提供された緯度および経度が住所から 1 キロ以上離れている場合は、バックエンドのジオコーディングから返されたデータで上書きします。

• 住所形式の一貫性に関する推奨事項
  連携をスムーズに行うため、Quote と Create Delivery リクエストのどちらにおいても、同じ住所形式（構造化と非構造化のいずれか）を使用して受け渡し住所を送信してください。使用する形式が異なるとジオコーディングの結果が変わり、システム内で「delivery location changed（配達場所が変更されました）」というエラーが生じる可能性があります。

  例：

  不適切

    - Quote Request: "dropoff_address": "190 Mathilda Pl, Sunnyvale, CA 94086"
    - Create Delivery Request: "dropoff_address": "{\"street_address\":[\"190 Mathilda Pl\",\"\"],\"city\":\"Sunnyvale\",\"state\":\"CA\",\"zip_code\":\"94086\"}"
  

  適切：構造化された住所

    - Quote Request: "dropoff_address": "{\"street_address\":[\"190 Mathilda Pl\"],\"city\":\"Sunnyvale\",\"state\":\"CA\",\"zip_code\":\"94086\"}"
    - Create Delivery Request: "dropoff_address": "{\"street_address\":[\"190 Mathilda Pl\"],\"city\":\"Sunnyvale\",\"state\":\"CA\",\"zip_code\":\"94086\"}"
  

  適切：構造化されていない住所

    - Quote Request: "dropoff_address": "190 Mathilda Pl, Sunnyvale, CA 94086"
    - Create Delivery Request: "dropoff_address": "190 Mathilda Pl, Sunnyvale, CA 94086"
  

¶ Update Delivery API を使用して更新できるのはどのフィールドですか？

以下のテーブルを参照してください。

¶ 店舗はどのようにして配達パートナーに連絡しますか？

• 配達パートナーが割り当てられると、Courier Update Webhook で次のフィールドが利用可能になります。
  • courier.public_phone_info.phone_number（匿名化された連絡先電話番号）
  • courier.public_phone_info.pin_code（認証用のセキュリティコード）
• 店舗は匿名化された phone_number に電話をかけることができます。
• 自動音声システムが発信者に「Uber の暗証番号」の入力を求めます。
• 正しい pin_code を入力すると、配達パートナーに電話がつながります。

¶ 店舗レベルのアクセスと役割の割り当て

販売業者は役割とスコープを含む role_assignments を渡すことができます。スコープは店舗レベルまたは組織レベルのいずれかを指定し、組織構造内でユーザー権限を細かく管理できます。

• role_assignments を有効にするには、組織で店舗レベルのアクセスを有効にする必要があります。Uber のアカウントマネージャーにお問い合わせください。
• 店舗レベルのアクセスが有効な場合、roles フィールドの値は無視され、role_assignments から役割が決定されます。有効でない場合は、従来どおり roles が使用されます。
• role_assignments の最大数は 1 です。
• 特定の店舗に external_store_id が設定されていない場合、その店舗に API 経由でメンバーを招待したい場合はアカウントマネージャーにお問い合わせください。または、external_store_id が設定されていない店舗については、Direct ダッシュボード上で役割を更新できます。
• 割り当て済みの役割は API 経由では更新できません。役割の更新は組織の Direct ダッシュボードから行ってください。

¶ Update Delivery：チップ

• Uber の配達パートナーのチップ保証は、配達パートナーの収入予測を確保し、注文者によりよいサービスを提供できるようにするものです。そのため、Update Delivery エンドポイントで更新できるチップは増額のみ可能です。
• チップの金額を誤って追加した場合は、まだ配達が開始されていなければキャンセルして再作成してください。
• チップの増額は、配達完了後、最大 3 週間まで更新できます。