REST Resource: inventory.partners.merchants

{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}

string

販売者リソース名（形式: partners/{partner_id}/merchants/{merchantId}）。

string

merchantName、電話番号、URL、地域は、パートナーの在庫を Google マップにすでに表示されている販売者とマッチングするために使用されます。この情報は表示されません。

販売者の名前。

string

販売者の国番号と市外局番を含む公開電話番号（例: +14567891234）。

string

販売者の公開ウェブサイトの URL。

object (GeoCoordinates)

販売者の地理情報（緯度、経度、住所など）。

string

アグリゲータのプラットフォームにおけるビジネスのカテゴリ。

string (int64 format)

このフィールドのサポートは終了しました。

integer (uint32 format)

販売者の税率（ベーシス ポイント: 1% の 100 分の 1）。たとえば、税率が 7.5% の場合は、このフィールドを 750 に設定します。

このフィールドを未設定か 0 に設定した場合、この販売者が提供するサービスに対してユーザーに請求される合計金額は、Service.price で指定された価格になります。サービスの価格は、税金が免除されているか、適用される税金がすでに含まれているとみなされます。税金が別項目でユーザーに表示されることはありません。

このフィールドがゼロ以外の値に設定されている場合、その販売者が提供するサービスの合計価格には、サービスの価格と税金（ここで指定された税率を基に算出）が含まれます。最小通貨単位の端数（1 セントの端数など）は、最近接偶数に丸められます。税金は別項目でユーザーに表示されます。

このフィールドのサポートは終了しました。代わりに、taxRate を使用してください。

object (TaxRate)

販売者の税率。指定されている場合、非推奨の taxRateBasisPoints フィールドがオーバーライドされます。メッセージが空の場合（taxRate { } など）、適用される税率はゼロにリセットされます。

object (PaymentRestrictions)

この販売者が受け付ける支払い方法に関する制限。このフィールドが設定されていない場合、制限は存在しないとみなされます。

object (PaymentOption)

この販売者で利用可能な支払いオプション。この販売者のサービスでは、利用可能な支払いオプションを個別に制限できます。

object (PaymentProcessorConfig)

トークン化された決済代行業者の設定（販売者がサポートしている場合）。

object (TokenizationConfig)

トークン化された決済代行業者の設定（販売者がサポートしている場合）。

object (Terms)

「Google で予約」でサービスを予約するときにユーザーに表示される、特定の販売者の利用規約。アグリゲータ パートナーの利用規約は常にユーザーに表示されるため、これに加えてアグリゲータ パートナーの利用規約はここでは提供しないでください。

string

パートナーの帰属を表示する際に使用する、消費者向けのブランドを識別する不透明型の文字列。このフィールドを使用すると、複数の消費者向けブランドを所有するパートナーが、同じフィード内のすべてのブランドの販売者を指定できます。

ブランドは、名前、ロゴ、利用規約、プライバシー ポリシーなど、消費者向けのプロパティで構成されます。

消費者向けのパートナー ブランドが 1 つしかない場合は、このフィールドを設定する必要はなく、無視してかまいません。

パートナーの種類別の処理方法:

消費者向けのブランドが 1 つしかない場合は、このフィールドは無視します。

複数のブランドが設定されている場合は、次のように処理されます。

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

注意: ほとんどのパートナーは、このフィールドを設定する必要はありません。パートナーがこのフィールドを使用する場合は、各ブランド（デフォルトのブランドを含む）を個別に設定する必要がありますので、Google までご連絡ください。

object (MerchantMatchingHints)

販売者が Google マップの場所とマッチングされる際のヒント注: 上記で指定した情報を使用して販売者と Google マップの場所がマッチングされるため、ほとんどのパートナーはこのフィールドを設定する必要がありません。（省略可）

object (ServiceAttribute)

この販売者のサービスを説明するために使用されるサービス属性の定義。（省略可）

object (ActionLink)

省略可。関連する言語を含むアクション URL、表示を制限する国のリスト、タイプ、このアクションを実行するプラットフォームを指定するオプションのプラットフォーム。

object (Advisement)

省略可。「Google で予約」を通じて順番待ちリストに登録するユーザーに対する、特定の販売者からの一般的なアドバイス。アドバイザリー内の個々のテキスト フィールドの長さは 100 バイト以内にする必要があります。

object (EconomicOperator)

省略可。規制遵守のために必要な、この特定の販売者に関連付けられた経済事業者の情報。（省略可）

{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}

object (CreditCardRestrictions)

この販売者が受け付けるクレジット カードに関する制限。このフィールドが設定されていない場合は、すべてのクレジット カードが受け付けられるとみなされます。なお、CreditCardType でサポートされるカードの数は今後増える予定ですので、このフィールドを空にすると今後、設定が変更される可能性があります。

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum (CreditCardType)

サポートされているクレジット カードのリスト。空の場合、クレジット カードはサポートされません。

{
  "paymentOptionId": string,
  "name": string,
  "description": string,
  "price": {
    object (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}

string

この ID は、この支払いオプションを識別するために使用されます。

この ID はアグリゲータ全体に適用されます。複数の販売者に値を再利用している場合、ユーザーは対応する支払いオプションでそれらの販売者に支払いを行うことができます。

ID を複数の販売者で再利用する場合、ある販売者の支払いオプションの値を更新すると、別の販売者の同じ ID の支払いオプションも更新されます。そのため、すべての支払いオプションで同じ ID を共有し、常に同じ値に更新することで、予測できない動作を回避することをおすすめします。

string

支払いオプションの名前。これはユーザーに表示されます。

string

支払いオプションについての説明。これはユーザーに表示されます。

object (Price)

支払いオプションの価格。

object (TaxRate)

この支払いオプションの税率。指定されている場合、Merchant または Service に存在する taxRate フィールドがオーバーライドされます。メッセージが空の場合（taxRate { } など）、適用される税率はゼロにリセットされます。

enum (PaymentOptionType)

この支払いオプションの種類。ドロップインには 1 回限り、パックには複数回、メンバーシップには無制限の使用が可能。

string (int64 format)

この支払いオプションを利用できるセッション数。値が 1 以上となるマルチセッションやパックの場合にのみ有効。

object (TimeRange)

支払いオプションを購入できる期間。

object (TimeRange)

支払いオプションはこの期間内に利用できます（例: 2017 年 1 月の特別価格）。指定されている場合は、validDuration と activationType がオーバーライドされます。

string (Duration format)

支払いオプションの有効期間（例: 30 日間のメンバーシップ）。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

enum (ActivationType)

この支払いオプションが有効となる開始日を決定する方法を定義します。

object (UserPurchaseRestriction)

この支払いオプションを購入できるユーザーを制限します。プロモーションの支払いオプションを一部のユーザーに制限するために使用できます。設定されていない場合、すべてのユーザーが対象となります。

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

boolean

以前に同じ販売者から購入したことがないユーザーのみが購入できる支払いオプション。

boolean

以前に同じ支払いオプションを購入したことがないユーザーのみが購入できる支払いオプション。

{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}

enum (Processor)

この設定が適用される決済代行業者を定義します。

string

この販売者を決済代行業者に応じて識別するために使用するキー。

Stripe については、https://stripe.com/docs/dashboard#api-keys をご覧ください。Braintree については、https://articles.braintreepayments.com/control-panel/important-gateway-credentials をご覧ください。

string

支払いリクエストとともに決済代行業者に送信される API バージョン番号。

{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}

map (key: string, value: string)

トークン化の設定には通常、キーが「gateway」で値が決済代行業者の名前である tokenizationParameter が 1 個あります。

パラメータの残りは決済代行業者によって異なります。詳しくは、Google Pay のドキュメントをご覧ください。

Braintree の例: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Stripe の例: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen の例: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

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

enum (BillingInformationFormat)

Google Pay に入力したユーザーの支払い情報（FOP を含む）を、支払いトークンに含めます（上記を参照）。フィールドを空のままにすると、MIN を指定した場合と同じ処理を行います。

{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}

string

必要に応じて、利用規約の URL。

string

ユーザーに表示するテキスト。新しい統合の場合は、下記の localizedText を使用します。

object (Text)

ユーザーに表示するローカライズされたテキスト。

{
  "placeId": string
}

string

Google プレイス データベースと Google マップ上の場所の Place ID。Place ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。

{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}

string

同じ販売者のサービス属性を他のサービス属性から一意に識別する ID（「account-type」など）。

string

この属性のユーザーに表示される名前（「口座種別」など）。

object (Value)

このサービス属性で可能なすべての値。

{
  "valueId": string,
  "valueName": string
}

string

このサービス属性の値を他の値から一意に識別する ID（「personal」など）。

string

ユーザーに表示される、この値の名前（「個人」など）。

{
  "text": {
    object (Text)
  }
}

object (Text)

「Google で予約」で予約するときにユーザーに表示されるカスタム メッセージ。

{
  "text": {
    object (Text)
  }
}

object (Text)

必須。経済事業者の氏名、住所、電話番号、メールアドレス。経済事業者とは、製造者、正式な代表者、輸入業者、販売業者、フルフィルメント サービス プロバイダ、または製品の製造、提供、使用に関連する義務を負うその他の自然人または法人を指します。economicOperator の自由形式の文字列表現。この情報は「"」と「\n」を使用してフォーマットできます。