重要: Content API for Shopping は 2026 年 8 月 18 日 に提供を終了します。

Merchant API への移行にさらに時間が必要な場合は、 Content API for Shopping へのアクセス期間の延長を申請してください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

ポイントプログラムの概要

ポイントプログラムを利用して、Google で店舗のメリットをアピールしましょう。送料無料、利用可能なポイント、会員限定価格など、さまざまな特典を登録できます。ポイントプログラムの特典は、Google 検索、ショッピングタブ、Google ウォレットなどの Google サービスにわたり、無料リスティング、ショッピング広告、ローカル在庫広告に表示できます。

Merchant API を使用すると、販売者と販売者の代理を務めるサードパーティのポイントプログラムプロバイダは、LoyaltyProgramService を使用してポイントプログラムをプログラムで設定および管理できます。このサービスでは、ポイントプログラムの作成、取得、一覧表示、更新、削除を行うことができます。

ビジネス要件とポリシーガイドラインについて詳しくは、Merchant Center ヘルプセンターの販売者のポイントプログラムについてをご覧ください。

主なコンセプト

ポイントプログラムを使用する際は、次のコンセプトと制限事項に注意してください。

アカウントレベルの識別子: Merchant API は、所有している Merchant Center アカウント ID でポイントプログラムを識別します。
単一プログラムの制限: Merchant API でサポートされているポイントプログラムは、販売アカウントごとに 1 つのみです。
直接アカウントの所有権: ポイントプログラムは、対象の販売アカウント（accounts/{ACCOUNT_ID}）で直接設定する必要があります。このサービスでは、サブアカウントの高度なアカウントレベルでポイントプログラムを管理することはできません。販売者のアカウントへのアクセス権を付与されたサードパーティのポイントプログラムプロバイダは、販売者の代わりにプログラムを管理できます。
編集審査: ロイヤリティプログラムを作成または更新すると、プログラムは審査を受けます。review_result.review_status フィールドは、プログラムが UNDER_REVIEW、APPROVED、または REJECTED かどうかを示します。
サポートされている地域: 販売者のポイントプログラムは、オーストラリア、ブラジル、カナダ、フランス、ドイツ、インド、イタリア、メキシコ、オランダ、韓国、スペイン、英国、米国などのサポートされている国でご利用いただけます。
ティアの要件: ティアには、参加費が無料のもの、メンバーシップ料金が必要なもの、利用額のしきい値が必要なもの、販売者ブランドのクレジットカードが必要なものがあります。職業に基づく階層（学生や軍人の階層など）はサポートされていません。
特典とメリット: プログラムでは、送料無料、利用可能なポイント、メンバー価格がサポートされています。広告でメンバー価格を表示するには、通常価格またはセール価格から 5% または 5 通貨単位以上の割引が必要です。

前提条件

Merchant API でポイントプログラムを管理する前に、次の要件を満たしていることを確認してください。

有効な Merchant Center アカウントが必要です（サードパーティのポイントプログラムプロバイダの場合は、販売者のアカウントへの承認済みアクセス権が必要です）。
アカウントのポイント プログラムアドオンを有効にします。アドオンは、次のいずれかの方法で有効にできます。
- Merchant Center の UI: Merchant Center ヘルプのポイントプログラムを設定するの手順に沿って操作します。
- Programs サブ API: Programs サブ API でプログラムを有効にするの説明に沿って、プログラムでプログラムを有効にします。

Programs サブ API を使用してポイントプログラムアドオンを有効にするリクエストの例を次に示します。

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable

cURL

curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

メソッド

ポイントプログラムは次の方法で管理します。

loyaltyPrograms.create
loyaltyPrograms.get
loyaltyPrograms.list
loyaltyPrograms.update
loyaltyPrograms.delete

ポイントプログラムを作成する

アカウントの新しいポイントプログラムを作成するには、loyaltyPrograms.create メソッドを使用します。プログラムの説明、登録 URL、プログラムの階層とその独自の特典と要件などの詳細を指定します。

必須の program_label は、ポイントプログラムの一意の識別子を設定します。たとえば、ラベル my-rewards を指定すると、リソース name は accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards になります。

リクエストの例を次に示します。

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

{
  "programLabel": "my-rewards",
  "loyaltyProgram": {
    "programName": "my rewards",
    "tiers": [
      {
        "tierName": "gold",
        "tierLabel": "gold",
        "tierBenefits": [
          {
            "otherBenefit": "free gift on your birthday"
          },
          {
            "structuredBenefit": {
              "pointsEarningBenefit": {
                "minimumMoneySpent": {
                  "currencyCode": "USD",
                  "units": "25"
                },
                "pointsEarningBenefitAnnotation": {
                  "pointsEarned": 1.0,
                  "amountSpent": {
                    "currencyCode": "USD",
                    "units": "1"
                  }
                }
              }
            }
          }
        ],
        "requirements": {
          "freeToJoin": true
        }
      }
    ],
    "programDescriptions": [
      "earn rewards buying products you love"
    ],
    "signupUrl": "https://www.example.com/my_rewards_signup",
    "regionCodes": [
      "US"
    ]
  }
}

{ACCOUNT_ID} は、Merchant Center アカウントの固有識別子に置き換えます。

以下は、リクエストが成功した場合のレスポンスの例です。

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

ポイントプログラムを取得する

特定の自社所有のポイントプログラムの詳細を取得するには、loyaltyPrograms.get メソッドを使用します。

リクエストの例を次に示します。

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

{ACCOUNT_ID} はアカウント ID に、{PROGRAM_LABEL} はポイントプログラムの一意のラベル（my-rewards など）に置き換えます。

以下は、リクエストが成功した場合のレスポンスの例です。

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

ポイントプログラムの一覧を取得する

アカウントに関連付けられているすべての自社所有のポイントプログラムを一覧表示するには、loyaltyPrograms.list メソッドを使用します。

リクエストの例を次に示します。

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

以下は、リクエストが成功した場合のレスポンスの例です。

{
  "loyaltyPrograms": [
    {
      "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
      "programName": "my rewards",
      "tiers": [
        {
          "tierName": "gold",
          "tierLabel": "gold",
          "tierBenefits": [
            {
              "otherBenefit": "free gift on your birthday"
            },
            {
              "structuredBenefit": {
                "pointsEarningBenefit": {
                  "minimumMoneySpent": {
                    "currencyCode": "USD",
                    "units": "25"
                  },
                  "pointsEarningBenefitAnnotation": {
                    "pointsEarned": 1.0,
                    "amountSpent": {
                      "currencyCode": "USD",
                      "units": "1"
                    }
                  }
                }
              }
            }
          ],
          "requirements": {
            "freeToJoin": true
          },
          "signupUrl": "https://www.example.com/my-rewards/gold"
        }
      ],
      "programDescriptions": [
        "earn rewards buying products you love"
      ],
      "signupUrl": "https://www.example.com/my_rewards_signup",
      "reviewResult": {
        "reviewStatus": "UNDER_REVIEW"
      },
      "regionCodes": [
        "US"
      ]
    }
  ]
}

ポイントプログラムを更新する

既存のポイントプログラムを更新するには、loyaltyPrograms.update メソッドを使用します。update_mask を使用して部分更新を行うか、マスクを省略して完全置換を行います。

更新マスクを使用した部分更新

update_mask を使用すると、更新するフィールドを正確に指定できます。マスクにリストされているフィールドのみが変更され、リストされていないフィールドは変更されません。更新マスクから省略されたフィールドは、リクエスト本文で指定されていても無視されます。

次のサンプルリクエストでは、programDescriptions と advancedSettings のみが更新されます。

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}?update_mask=program_descriptions,advanced_settings

{
  "programDescriptions": [
    "a new description of the program"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  },
  "signupUrl": "https://www.example.com"
}

この例では、signupUrl は update_mask に含まれていないため、サービスによって無視されます。programDescriptions フィールドは、以前に構成された説明を完全に置き換えます。

以下は、リクエストが成功した場合のレスポンスの例です。

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "a new description of the program"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  }
}

更新マスクなしの完全な置き換え

update_mask パラメータを省略すると、リクエストはポイントプログラム構成の完全な置き換えを実行します。

リクエストの例を次に示します。

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

{
  "programName": "Updated Program",
  "signupUrl": "https://example.com/updated",
  "programDescriptions": [
    "Updated description"
  ],
  "regionCodes": [
    "US"
  ],
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ]
}

以下は、リクエストが成功した場合のレスポンスの例です。

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "Updated Program",
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ],
  "programDescriptions": [
    "Updated description"
  ],
  "signupUrl": "https://example.com/updated",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

ポイントプログラムを削除する

アカウントからポイントプログラムを削除するには、loyaltyPrograms.delete メソッドを使用します。

リクエストの例を次に示します。

HTTP

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

成功すると、レスポンスの本文は空になります。

次のステップ

Google 検索でのオーガニックなカスタマイズのために、個々の買い物客をポイントプログラムのメンバーシップレベルに関連付けるには、ポイントプログラムの顧客照合サービスガイドをご覧ください。
アカウントのショッピングプログラムを有効または無効にするには、プログラムサブ API ガイドをご覧ください。
ビジネスの設定、編集ポリシー、レポートについて詳しくは、Merchant Center ヘルプの販売者ポイントプログラムについてをご覧ください。
API メソッドとリソース定義については、Merchant API リファレンスをご覧ください。

Manage customer loyalty data

ポイント プログラムの概要 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

主なコンセプト

前提条件

HTTP

cURL

メソッド

ポイント プログラムを作成する

HTTP

ポイント プログラムを取得する

HTTP

ポイント プログラムの一覧を取得する

HTTP

ポイント プログラムを更新する

更新マスクを使用した部分更新

HTTP

更新マスクなしの完全な置き換え

HTTP

ポイント プログラムを削除する

HTTP

次のステップ

ポイントプログラムの概要

ポイントプログラムを作成する

ポイントプログラムを取得する

ポイントプログラムの一覧を取得する

ポイントプログラムを更新する

ポイントプログラムを削除する