Order

string

ユーザーのメールアドレス（例: janedoe@gmail.com）。

string

ユーザーの名（ファースト ネーム）。

string

ユーザーの姓。

string

ユーザーの表示名。姓や名とは異なる場合があります。

object (PhoneNumber)

ユーザーの電話番号。

string

国際電気通信連合（ITU）勧告 E.164 で定義されている E.164 形式の電話番号。Wiki のリンク: https://en.wikipedia.org/wiki/E.164

string

内線番号については、長さが最大 40 桁の一連の番号であることを除き、ITU 勧告で標準化されていません。ここでは、内線番号の先頭にゼロを使用できるようにするため、文字列として定義されています（標準は定められていないため、自由に決定できます）。桁数以外に、「,」（ポーズを指します）などの他のダイヤル文字もここに保存されます。たとえば、xxx-xxx-xxxx のように指定します。123、「123」拡張機能です

string

国内でこの電話番号を発信する際に推奨される携帯通信会社の選択コード。これには、固定電話から携帯電話（またはその逆）への通話時に一部の国で発信する必要があるコードも含まれます。たとえば、コロンビアでは、携帯電話から国内の固定電話（またはその逆）にかけるときに電話番号の前に「3」をダイヤルする必要があります（https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia、https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code）。

これは「推奨」コードなので、他のコードも使用できます。

string

画像のソース URL。JPG、PNG、GIF（アニメーション GIF と非アニメーション GIF）を使用できます。例: https://www.agentx.com/logo.png。必須です。

string

スクリーン リーダーなどのユーザー補助機能で使用される画像の説明テキスト。必須です。

number

画像の高さ（ピクセル単位）。省略可能。

number

画像の幅（ピクセル単位）。省略可能。

string

販売者に割り当てられたオプションの ID（ある場合）。

string

販売者の名前（「Panera Bread」など）。

object (Image)

販売者に関連付けられている画像。

object (PhoneNumber)

販売者の電話番号。

object (Location)

販売者の住所。

object (LatLng)

地理座標。[DEVICE_PRECISE_LOCATION] が必要 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 権限。

string

表示住所。例: 「1600 Amphitheatre Pkwy, Mountain View, CA 94043」。[DEVICE_PRECISE_LOCATION] が必要 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 権限。

string

郵便番号。[DEVICE_PRECISE_LOCATION] が必要 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] または [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] 権限。

string

市区町村。[DEVICE_PRECISE_LOCATION] が必要 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] または [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] 権限。

object (PostalAddress)

郵便住所。[DEVICE_PRECISE_LOCATION] が必要 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] または [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] 権限。

string

場所の名前です。

string

ビジネス拠点の電話番号（例:ビジネス拠点の連絡先電話番号または配送先の電話番号。

string

場所に関するメモです。

string

placeId は、場所の詳細をフェッチするために Places API で使用されます。https://developers.google.com/places/web-service/place-id をご覧ください。

number

緯度（度単位）。[-90.0, +90.0] の範囲内で指定する必要があります。

number

経度（度単位）。[-180.0, +180.0] の範囲内で指定する必要があります。

number

PostalAddress のスキーマ リビジョン。最新のリビジョンである 0 に設定する必要があります。

新しいリビジョンはすべて、古いリビジョンと下位互換性があることが必要です。

string

必須。住所の国 / 地域に対応する CLDR 地域コード。この値は推測されることはなく、正確な値が確保されるかどうかはユーザー次第です。詳細については、http://cldr.unicode.org/ と http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。例: 「CH」設定しています

string

省略可。この住所の表記に使われている BCP-47 言語コード（わかっている場合）。多くの場合、これは入力フォームの UI 言語です。あるいは、住所の国や地域で使用されているいずれかの言語、またはそれらの言語を音訳したものと一致する場合もあります。これは特定の国で住所のフォーマットに影響する可能性がありますが、データの正確性にとっては重要でなく、検証やその他のフォーマット関連以外の操作には影響しません。

この値が不明な場合は省略してください（間違っている可能性があるデフォルトは指定しないでください）。

例: 「zh-Hant」、「ja」、「ja-Latn」、「en」。

string

省略可。住所の郵便番号。すべての国で、郵便番号は使用または必須というわけではありませんが、使用されている場合、住所の他の部分による追加検証（例: 米国での州/郵便番号の検証）が行われる場合があります。

string

省略可。追加の国固有の並べ替えコード。ほとんどの地域では、これは使用されていません。「CEDEX」のような文字列の後に数字が続く形式（「CEDEX 7」など）か、数字のみ（「セクター コード」を表す）のいずれかになります。（ジャマイカ）、「配達地域表示」（マラウイ）または「郵便局インジケーター」（例: コートジボワール）。

string

省略可。その国 / 地域の住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがこれに該当します。特にスペインでは、これは自治州ではなく県になります（例: 「カタルーニャ」ではなく「バルセロナ」）。州や県などの行政区画が住所表記に使用されない国もあります。例:未設定のままにする必要があります。

string

省略可。通常は住所の市区町村の部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町名などがこれに該当します。地域区分が十分に定義されていない地域や、この構造にうまく適合しない地域では、locality を空白のままにして addressLines を使用します。

string

省略可。住所の市町村部分の下位の区画。たとえば、地区、特別区、地区などがあります。

string

住所の下位部分を記述する非構造化の住所行。

addressLines の値は型情報を持たず、単一のフィールドに複数の値を含めることができるため（例: 「Austin, TX」）、行の順序が明確であることが重要です。住所行の順序は、その住所の国 / 地域の「封筒順」であることが必要です。これが一定でない可能性のある場所（日本など）では、address_language を使用して明示的に指定します（例: 順序が大区分から小区分の場合は「ja」、小区分から大区分の場合は「ja-Latn」または「en」）。このように、住所の最も詳細な部分の行を言語に基づいて選択できます。

住所の構造化表現として許容される最小限の形式は、regionCode を設定し、残りすべての情報を addressLines に格納するというものです。そのような住所を、ジオコーディングなしできわめて正確に近く書式設定することも可能ですが、住所の構成要素についての意味的な推論は、少なくとも部分的に解決されるまでは不可能です。

完全に構造化されていない住所を処理するには、（住所のどの部分が地域区分で、どの部分が行政区域であるかを推測するのではなく）regionCode と addressLines のみを含む住所を作成してからジオコーディングを行うことをおすすめします。

string

省略可。その住所で受け取る人。このフィールドには、場合によっては複数の情報を含めることができます。たとえば、「care of」という単語が含まれる場合があります。情報です。

string

省略可。その住所にある組織の名前。

object (LineItem)

注文の項目のリスト。少なくとも 1 つの lineItem が必要です。最大 50 個の項目を含めることができます。広告申込情報はすべて同じカテゴリに属している必要があります。

string

必須: 項目に対して割り当てられた販売者 ID。部分更新を適用する際に既存の項目を識別するために使用されます。最大文字数は 64 文字です。

string

領収書に表示される項目の名前。最大文字数は 100 文字です。

string

非推奨。代わりに、カテゴリレベルのステータスを使用します。たとえば、購入の場合、PurchaseOrderExtension.status を使用します。この項目の状態についてユーザーに表示されるラベルです。

object (Merchant)

特定の項目のプロバイダ（注文全体と異なる場合）。例: Expedia の注文と項目プロバイダ ANA。

object (PriceAttribute)

広告申込情報レベルの価格と調整。

object (Action)

項目でのフォローアップ アクション。

object (UserInfo)

項目レベルの購入者。これは注文レベルの購入者とは異なる場合があります。例: ユーザー X がユーザー Y の名前でレストランを予約した場合。

object (Image)

このアイテムに関連付けられた小さい画像（ある場合）。

string

広告申込情報の説明。

string

キャンセル ポリシーなど、この広告申込情報に関するその他の注意事項。

object (Disclosure)

この広告申込情報に関連付けられている開示。

object

非推奨: 代わりにカテゴリを使用してください。必須: タイプまたはカテゴリに基づく項目のセマンティック コンテンツ。すべてのカテゴリに、固有のフルフィルメントの詳細を含める必要があります。次のいずれかの値にする必要があります。google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

任意の型のフィールドを含むオブジェクト。型を識別する URI を含むフィールド "@type" を追加できます。例: { "id": 1234, "@type": "types.example.com/standard/id" }

object (PurchaseItemExtension)

商品や食品などの注文。

object (ReservationItemExtension)

レストランやヘアカットなどの予約注文

enum (Type)

必須: 金額属性のタイプ。

string

必須: ユーザーに表示される価格属性の文字列。これは販売者が送信し、ローカライズします。

enum (State)

必須: 価格の状態: 見積もりか実際の価格か。

boolean

価格が税込みかどうか。

object (Money)

金額。

number

割合の spec で、0.001 パーセントが 1 で表されます。たとえば、8.750% は 8,750 として表されます。負の割合は割引率を表します。このフィールドは非推奨です。堅実なユースケースが求められる場合に、このフィールドの使用を検討できます。

string

ISO 4217 で定義されている 3 文字の通貨コード。

string (int64 format)

100 万分の 1 単位で表された金額。たとえば、$1.99 の場合、このフィールドには 1990000 を設定する必要があります。

enum (Type)

必須: アクションのタイプ。

string

ユーザーに表示されるアクションのタイトルまたはラベル。最大文字数は 100 文字です。

object (OpenUrlAction)

必要な対応。

object (ActionMetadata)

アクションに関連付けられたメタデータ。

string

次の URL フィールドのいずれか: - アプリとリンクしたアプリまたはウェブページを開くための http か https の URL

object (AndroidApp)

Android アプリに関する情報（URL が Android アプリによって処理されることを想定している場合）。

enum (UrlTypeHint)

URL タイプのヒントを示します。

string

パッケージ名: Android フルフィルメントを指定する際は、パッケージ名を指定する必要があります。

object (VersionFilter)

複数のフィルタを指定した場合、フィルタが一致するとアプリがトリガーされます。

number

最小バージョン コードまたは 0（両端を含む）。

number

最大バージョン コード（指定されたバージョンを含む）。考慮される範囲は [minVersion:maxVersion] です。null の範囲は任意のバージョンを意味します。例: 単一のバージョンを指定するには、[target_version:target_version] を使用します。任意のバージョンを指定するには、minVersion と maxVersion を未指定のままにします。maxVersion までのすべてのバージョンを指定するには、minVersion を未指定のままにします。minVersion からすべてのバージョンを指定するには、maxVersion を未指定のままにします。

string (Timestamp format)

このアクションの有効期限が切れる日時。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"。

string

開示のタイトル。例: 「安全性に関する情報」。

object (DisclosureText)

開示の内容。ウェブリンクは使用できます。

object (DisclosurePresentationOptions)

開示の表示オプション。

string

表示するテキスト。挿入する各テキストリンクに対応する「{0}」や「{1}」などのプレースホルダを含みます。例: 「警告: この製品を使用すると、癌を誘発する可能性があるとカリフォルニア州で認識されている化学物質にさらされるおそれがあります。詳しくは、{0} をご覧ください。」この開示テキストに、宣伝や広告のようなコンテンツを含めることはできません。

object (TextLink)

テンプレート内のプレースホルダと置き換えるテキストリンク。最初の名前が「{0}」に置き換えられます2 番目は "{1}" のようになります。

string

ユーザーに表示するテキスト。

string

リンクが有効化されたときのユーザーの誘導先となる URL。

enum (PresentationRequirement)

開示の提示要件。

boolean

開示の内容を最初から展開しておくかどうか。デフォルトでは、閉じた状態です。

enum (PurchaseStatus)

必須: 広告申込情報レベルのステータス。

string

必須: ユーザーに表示されるステータスのラベルまたは文字列。最大文字数は 50 文字です。

enum (PurchaseType)

必須: 購入のタイプ。

string

この項目に関連付けられた商品 ID またはオファー ID。

number

商品の数量。

object (MerchantUnitMeasure)

単位。選択した単位で項目のサイズを指定します。単価は、サイズと有効な価格に基づいて決定されます。

object (PurchaseReturnsInfo)

この項目の返品情報。未設定の場合、この広告申込情報は注文単位の返品情報を継承します。

object (PurchaseFulfillmentInfo)

この項目のフルフィルメント情報。未設定の場合、この広告申込情報は注文レベルのフルフィルメント情報を継承します。

object (ItemOption)

追加のアドオンまたはサブアイテム。

object

販売者と Google の間で交換される追加フィールド。

任意の型のフィールドを含むオブジェクト。型を識別する URI を含むフィールド "@type" を追加できます。例: { "id": 1234, "@type": "types.example.com/standard/id" }

object (ProductDetails)

商品の詳細。

number

値: 例 1.2。

enum (Unit)

単位: 例 POUND、GRAM

boolean

true の場合、戻り値は許可されます。

number

その日数以内であれば返品できます。

string

返品に関するポリシーへのリンク。

string

このサービス オプションの一意の識別子。

enum (Type)

必須: フルフィルメントのタイプ。

object (Time)

時間範囲が指定されている場合は時間枠、または単一の時間が指定されている場合は到着予定時刻。 配送または受け取りの目安時間。

object (Time)

時間範囲が指定されている場合は時間枠、または単一の時間が指定されている場合は到着予定時刻。 料理の準備にかかる予定時間。1 回限りのことが推奨されます。

object (Location)

受け取り場所または配達場所。

string (Timestamp format)

このフルフィルメント オプションの有効期限が切れる日時。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒。例: "2014-10-02T15:01:23.045123456Z"。

object (PriceAttribute)

このオプションの費用。

object (UserInfo)

このフルフィルメントのユーザーの連絡先。

string

ユーザーが選択した配送方法の名前。

string

店舗の StoreCode。例: Walmart が販売者で、storeCode がフルフィルメントが発生した Walmart の店舗です。https://support.google.com/business/answer/3370250?ref_topic=4596653.

object (PickupInfo)

注文の受け取り方法に関する追加情報。このフィールドは、フルフィルメント タイプが PICKUP の場合にのみ適用されます。

string

予約時間や配達時間など、注文イベントにおける時間を表します。期間（開始時間と終了時間）、日付、日時などを指定できます。サポートされているすべての形式については、https://en.wikipedia.org/wiki/ISO_8601 をご覧ください。

enum (PickupType)

INSTORE、CURBSIDE などの受け取り方法

object (CurbsideInfo)

店舗受け取り情報固有の詳細。 pickupType が「CURBSIDE」でない場合、このフィールドは無視されます。

object (CheckInInfo)

パートナーがチェックインをサポートするさまざまな方法のリスト。

enum (CurbsideFulfillmentType)

店舗受け取り注文には追加情報が必要です。選択したフルフィルメント タイプに応じて、対応する詳細情報がユーザーから収集されます。

object (Vehicle)

注文したユーザーの車両詳細。

string

自動車のメーカー（例: 「Honda」）。これはユーザーに表示されるため、ローカライズする必要があります。必須です。

string

自動車のモデル（例: 「Grom」）。これはユーザーに表示されるため、ローカライズする必要があります。必須です。

string

自動車のナンバー プレート番号（例: 「1ABC234」）。必須です。

string

車両の色名（例:黒 省略可。

object (Image)

自動車の写真の URL。写真は約 256 x 256 ピクセルで表示されます。jpg または png である必要があります。省略可能。

enum (CheckInType)

チェックインの手順を送信する方法。

string

アイテムがアイテムの場合、固有のアイテム ID。

string

オプション名。

object (PriceAttribute)

オプションの合計金額。

string

オプションに関するメモ。

number

アイテムがアイテムの場合は、数量です。

string

このオプションに関連付けられた商品 ID またはオファー ID。

object (ItemOption)

ネストされた他のサブオプションを定義するには:

string

この広告申込情報に関連付けられている商品 ID またはオファー ID。

string

商品の国際取引商品番号。Merchant Center に offerId がない場合に役立ちます。省略可能。

string

価格ルックアップ コード（一般的に PLU コード、PLU 番号、PLU、生産コード、農産物ラベルと呼ばれる）は、食料品店やスーパーマーケットで販売されている一括販売商品を一意に識別する番号システムです。

string

販売者が定義した商品カテゴリ。例:"ホーム >食料品 >乳製品、エッグ >牛乳 >全乳」

map (key: string, value: string)

販売者が提供する商品に関する詳細情報。例: { "アレルゲン": "ピーナッツ" }。Merchant Center に offerId がない場合に役立ちます。省略可。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

enum (ReservationStatus)

必須: 予約ステータス。

string

必須: ユーザーに表示されるステータスのラベルまたは文字列。最大文字数は 50 文字です。

enum (ReservationType)

予約のタイプ。該当しないタイプ オプションがない場合は、未設定のままにできます。

object (Time)

サービスまたはイベントの予約時間。期間、日付、または正確な日時を指定できます。

object (Time)

ユーザーが許容できる期間。

string

この予約の確認コード。

number

人数。

object (StaffFacilitator)

予約を担当するスタッフ。例: ヘアスタイリスト。

object (Location)

サービスまたはイベントの場所。

object

販売者と Google の間で交換される追加フィールド。

任意の型のフィールドを含むオブジェクト。型を識別する URI を含むフィールド "@type" を追加できます。例: { "id": 1234, "@type": "types.example.com/standard/id" }

string

担当スタッフの名前。例: "ジョン スミス"

object (Image)

パフォーマーの画像。

object (PaymentResult)

取引を完了するためにインテグレータによって使用される支払い結果。購入手続きが Actions-on-Google によって管理されている場合、このフィールドは Actions on Google によって入力されます。

object (PaymentInfo)

注文に関する支払い情報で、ユーザーとのやり取りに有用な情報です。

string

Google によって提供される支払い方法に関するデータ。お客様の決済代行業者が Google でサポートされている決済代行業者のリスト（https://developers.google.com/pay/api/）にある場合、このリンクからお客様の決済代行業者にアクセスし、詳細情報を確認してください。それ以外の場合は、ペイロードの詳細について次のドキュメントをご覧ください。https://developers.google.com/pay/api/payment-data-cryptography

string

ユーザーが選択した販売者/アクション提供のお支払い方法。

object (PaymentMethodDisplayInfo)

取引に使用されたお支払い方法の表示情報。

enum (PaymentMethodProvenance)

取引に使用された支払い方法の提供元。ユーザーは Google と販売者の両方に同じお支払い方法を登録している可能性がある

enum (PaymentType)

支払いのタイプ。

string

ユーザーに表示される支払い方法の名前。例: VISA **** 1234 Checking acct **** 5678

string

音声のみのアシスタント デバイスでユーザーに読み上げられるお支払い方法の名前。たとえば、「ビザが 1、2、3、4 で終わる」や「当座預金口座が 567 で終わる」などです。注: これは音声のみのアシスタント デバイスで、paymentMethodDisplayName の代わりに使用される音声に最適化された文字列です。この文字列が設定されていない場合は、代わりに paymentMethodDisplayName が読み上げられます。

string

必須: この特典に適用されるクーポンコード。

enum (PurchaseStatus)

必須: 注文の全体的なステータス。

string

ユーザーに表示されるステータスのラベルまたは文字列。最大文字数は 50 文字です。

enum (PurchaseType)

必須: 購入のタイプ。

object (PurchaseReturnsInfo)

注文の返品情報。

object (PurchaseFulfillmentInfo)

注文のフルフィルメント情報。

object

販売者と Google の間で交換される追加フィールド。

任意の型のフィールドを含むオブジェクト。型を識別する URI を含むフィールド "@type" を追加できます。例: { "id": 1234, "@type": "types.example.com/standard/id" }

enum (PurchaseLocationType)

購入場所（店舗またはオンライン）

object (PurchaseError)

省略可: 注文が拒否された原因となるエラー。

enum (ErrorType)

必須: 注文が販売者によって拒否された詳細な理由を表します。

string

エラーの追加の説明。

string

エラーに対応するエンティティ ID。たとえば、これは LineItemId / ItemOptionId に対応します。

object (PriceAttribute)

PRICE_CHANGED / INCORRECT_PRICE のエラータイプの場合に関連します。

number

現在入手可能な数量。AVAILABILITY_CHANGED の場合に適用されます。

object (TicketEvent)

すべての項目チケットに適用されるイベント。

enum (Type)

必須: チケットイベントのタイプ（例:映画、コンサート

string

必須: イベントの名前。たとえば、イベントが映画の場合は、映画の名前を指定します。

string

イベントの説明。

string

イベント情報への URL。

object (Location)

イベントが行われる場所、または組織の所在地。

object (EventCharacter)

このイベントの関係者。映画イベントの監督や俳優、コンサートのパフォーマーなどです。

object (Time)

開始時間。

object (Time)

終了時間。

object (Time)

入場時間。イベントの開始時間とは異なる場合があります。例:イベントは午前 9 時開始ですが、入場時間は午前 8 時 30 分です。

enum (Type)

イベント文字のタイプ。例:俳優や監督。

string

キャラクターの名前。

object (Image)

登場人物の画像。