このページは Cloud Translation API によって翻訳されました。

アクセスの要件

ユーザーは、すでにアクセスできるコンテンツを視聴することを好みます。視聴できるコンテンツには、既存の定期購読コンテンツを表示したりできますユーザーが表示可能なコンテンツを Google が把握している場合アクセスできれば、Google がより優れた検索結果を構築できます。または応答を返してユーザーをそのコンテンツに誘導します。

コンテンツアクセスの要件を特定する

コンテンツパッケージごとにアクセス要件をカタログですその際は、次の点を考慮してください。

ユーザーがコンテンツにアクセスするには、アプリやプラットフォームにログインする必要があるか。
有料会員登録は必要か。

ウォッチアクションのみ:
- ユーザーは外部サービスプロバイダからのサブスクリプションが必要ですか？
- 階層型、複数パッケージ、アドオンのサブスクリプションを提供していますか？
ウォッチアクションのみ: ユーザーはコンテンツをレンタルまたは購入する必要がありますか？
アクセス要件は時間とともに変化するか。
アクセス要件はデバイスの位置情報によって異なりますか？

アクセス制限のタイプ

アクセス制限には次の 2 種類があります。

ペイウォールの種類
地域

ペイウォールの種類

ペイウォールの種類によってコンテンツへのアクセスを制限できます。次の表にペイウォールの種類について詳しく説明します

ペイウォールの種類	例	カテゴリ
購入やログインは必要ありません。	Crackle	`nologinrequired`
ユーザーはログインする必要がありますが、有料登録は必要ありません。	Vudu（AVOD）	`free`
有効な定期購入が必要です。アクセスは設定します。	Netflix	`subscription` 注: 一般的な Tier マークアップが必須です。
有効な定期購入が必要です。アクセス権は、提供します	Hulu（アドオン）	`subscription` <ph type="x-smartling-placeholder"> </ph> 注: 必要な資格 ID のセットを指定してください。このコンテンツには `MediaSubscription.identifier` でアクセスできます。詳細については、次をご覧ください: 利用資格 ID。また、共通階層のマークアップが必要になる場合があります。
終了後は、コンテンツを一定時間利用できます。購入します	Vudu	`rental`
終了後は、コンテンツを無期限に利用できる購入します	Vudu	`purchase`
このコンテンツは、ケーブルテレビを定期購入すると視聴できます。	HBO GO	`externalSubscription`

ウォッチアクションのペイウォールの種類

ウォッチアクションのコンテンツペイウォールタイプを指定するには、 category プロパティをアクションアクセスの仕様:

"potentialAction": {
  "@type":"WatchAction",
  "target": { … },
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "subscription",
    "availabilityStarts": "2018-06-01T10:35:29Z",
    "availabilityEnds": "2019-05-31T10:35:29Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  },
  ...
}

リッスンアクションのペイウォールタイプ

リッスンアクションのコンテンツペイウォールタイプを指定するには、 category プロパティを特典オブジェクト:

"potentialAction": {
  "@type":"ListenAction",
  "target": { … },
  "expectsAcceptanceOf":{
    "@type":"Offer",
    "category":"subscription",
    "availabilityStarts": "2018-06-01T10:35:29Z",
    "availabilityEnds": "2019-05-31T10:35:29Z",
    "eligibleRegion": {
      "@type":"Country",
      "name":"US"
    }
  },
  ...
}

地理的エリア

コンテンツを利用できる地域を指定する必要があります。1 つ以上の次の両方のプロパティを指定します。

eligibleRegion プロパティは、アクションアクセスの指定渡されます。このプロパティは必須です。
ineligibleRegion プロパティは、アクションアクセスの指定渡されます。

デバイスの位置が特定の国 / 地域内にあれば、ユーザーはコンテンツにアクセスできます。 eligibleRegion で指定されていて、かつ指定されたリージョン内にない ineligibleRegion。

eligibleRegion プロパティと ineligibleRegion プロパティを使用すると、次のことができます。 values:

リスト Country City、 State。
GeoShape オブジェクト。詳しくは、 GeoShape プロパティをご覧ください。
GeoShape オブジェクトのリスト。

コンテンツがグローバルに提供されている場合は、 eligibleRegion:

"eligibleRegion": "EARTH",

対象となるリージョンのユースケース

eligibleRegion プロパティのユースケースの例を次に示します。

例 1: 国のリストを含む eligibleRegion。
例 2: eligibleRegion を、次の GeoShape オブジェクトに置き換えます。には郵便番号のリストが含まれます。
例 3: eligibleRegion を、次の GeoShape オブジェクトに置き換えます。には、Forward Sortation Area（FSA）コードのリストが含まれています。
例 4: eligibleRegion を、次の GeoShape オブジェクトに置き換えます。 DMA ID が含まれています。
例 5: GeoShape オブジェクトのリストを含む eligibleRegion。それぞれに DMA ID が含まれています。
例 6: ブロックした郵便番号を含む ineligibleRegion。

例 1

eligibleRegion は、国のリストに置き換えます。

"actionAccessibilityRequirement": {
  "@type": "ActionAccessSpecification",
  "category": "subscription",
  "requiresSubscription": {
    "@type": "MediaSubscription",
    "@id": "http://www.example.com/north_america_network/subscription",
    "name": "Example Subscription",
    "commonTier": true
  },
  "eligibleRegion": [
    {
      "@type": "Country",
      "name": "US"
    },
    {
      "@type": "Country",
      "name": "CA"
    }
  ]
}

例 2

eligibleRegion は、次の GeoShape オブジェクトで置き換えます。には、郵便番号のリストが含まれます。

"actionAccessibilityRequirement": {
  "@type": "ActionAccessSpecification",
  "category": "subscription",
  "requiresSubscription": {
    "@type": "MediaSubscription",
    "@id": "http://www.example.com/local_tv_network/subscription",
    "name": "Example Subscription",
    "commonTier": true
  },
  "eligibleRegion": {
    "@type": "GeoShape",
    "@id": "http://example.com/area1",
    "addressCountry": "US",
    "postalCode": [
      "94118",
      "94119"
    ]
  }
}

例 3

eligibleRegion は、次の GeoShape オブジェクトで置き換えます。には、Forward Sortation Area（FSA）コードのリストが含まれます。

"actionAccessibilityRequirement": {
  "@type": "ActionAccessSpecification",
  "category": "subscription",
  "requiresSubscription": {
    "@type": "MediaSubscription",
    "@id": "http://www.example.com/local_tv_network/subscription",
    "name": "Example Subscription",
    "commonTier": true
  },
  "eligibleRegion":{
    "@type": "GeoShape",
    "@id": "http://example.com/area2",
    "addressCountry": "CA",
    "postalCode": [
      "1A1",
      "K1A"
    ]
  }
}

例 4

eligibleRegion は、次の GeoShape オブジェクトで置き換えます。に DMA ID が含まれています。

"actionAccessibilityRequirement": {
  "@type": "ActionAccessSpecification",
  "category": "subscription",
  "requiresSubscription": {
    "@type": "MediaSubscription",
    "@id": "http://www.example.com/abcd/subscription",
    "name": "Example Subscription",
    "commonTier": true
  },
  "eligibleRegion":{
    "@type": "GeoShape",
    "@id": "http://example.com/area3",
    "addressCountry": "US",
    "identifier": [
      {
        "@type": "PropertyValue",
        "propertyID": "DMA_ID",
        "value": "501"
      }
    ]
  }
}

例 5

eligibleRegion は、GeoShape オブジェクトのリストに置き換えます。それぞれに DMA ID が含まれています。

"actionAccessibilityRequirement" : {
   "@type" : "ActionAccessSpecification",
   "eligibleRegion" : [
      {
         "@id" : "http://example.com/dma/601",
         "@type" : "GeoShape",
         "addressCountry" : "US",
         "identifier" : {
            "@type" : "PropertyValue",
            "propertyID" : "DMA_ID",
            "value" : "601"
         }
      },
      {
         "@id" : "http://example.com/dma/602",
         "@type" : "GeoShape",
         "addressCountry" : "US",
         "identifier" : {
            "@type" : "PropertyValue",
            "propertyID" : "DMA_ID",
            "value" : "602"
         }
      }
   ]
}

例 6

ブロックされている郵便番号の ineligibleRegion:

"actionAccessibilityRequirement": {
  "@type": "ActionAccessSpecification",
  "category": "subscription",
  "requiresSubscription": {
    "@type": "MediaSubscription",
    "@id": "http://www.example.com/local_tv_network/subscription",
    "name": "Example Subscription",
    "commonTier": true
  },
 "eligibleRegion":   {
      "@type": "Country",
      "name": "US"
    },
  "ineligibleRegion": {
    "@type": "GeoShape",
    "@id": "http://example.com/area1",
    "addressCountry": "US",
    "postalCode": [
      "94118",
      "94119"
    ]
  }
}

登録情報 ID

利用資格 ID entitlementId は、以下を表す文字列を参照しています。メディアカタログ内のコンテンツのグループに対するアクセス権。ユーザーがコンテンツにアクセスできない場合、Google では次の処理を行います。

バックエンドサービスに Entitlements エンドポイントに、ユーザーの利用資格 ID。
Google は、メディアからコンテンツに必要な利用資格 ID を検索します。アクションフィード。
ユーザーの entitlementId を identifier プロパティのフィード内のメディアのチャンネル登録オブジェクト。少なくとも 1 つの entitlementId が一致すると、ユーザーは説明します。

で確認できます。 <ph type="x-smartling-placeholder">

**図 2.**ユーザーの利用資格 ID のいずれかが一致しているコンテンツに必要な利用資格 ID を指定します。

entitlementId には次の構文を使用することをおすすめします。

<domain name> + colon (:) + <access level to content>

構文の例:

example.com:basic
example.com:premium
example.com:sports

利用資格 ID の例

MediaExampleCompany のフィードでは、Movie XYZ では次に示すように、example.com:basic entitlementId にします。

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "www.example.com/movie_xyz",
  "url": "www.example.com/movie_xyz",
  "name": "Movie XYZ",
  "potentialAction": {
    "@type": "WatchAction",
    "target": [ … ],
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://www.example.com/basic_subscription",
        "name": "Basic subscription",
        "commonTier": true
        ...
      },
      ...
    }
  },
  ...
}

一般的なアクセスのユースケース

一般的なアクセスのユースケースは次のとおりです。

無料（ログイン不要）: コンテンツを利用できる点が異なります。
無料（ログインが必要）: コンテンツにはユーザーのログインが必要ですが、購読は必要ありません。
単一階層型サブスクリプション: コンテンツを利用するには有料会員登録が必要です。すべての購読者が同じ（定期購入に関係なく）は映画でもエピソードでも、パッケージ化されています。
多層サブスクリプション: コンテンツには有料会員登録が必要です。チャンネル登録者は映画かエピソードかを選択しますたとえば シルバーとゴールド。
アドオンサブスクリプション: コンテンツサブスクリプションが必要です。定期購入者は自分のコンテンツ上にプレミアムコンテンツを追加できます通常のサブスクリプション。
1 回だけの購入: コンテンツには購入すると、ユーザーは無期限にアクセスできます。
ライブテレビ: 定期購入では以下を利用できます。ローカル、全国、プレミアムチャンネル。
サードパーティの定期購入: このコンテンツを利用するには、ユーザーがケーブルテレビ会社にログインする必要があります。

ログイン不要

コンテンツはログインまたはサブスクリプションなしで利用できます。

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

category を nologinrequired に設定する。
expectAcceptanceOf は含めないでください。

ログインしてください

コンテンツにはユーザーのログインが必要ですが、。

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "free",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

category を free に設定する。
expectAcceptanceOf は含めないでください。

単一階層型のサブスクリプション

単一階層のサブスクリプションモデルでは、サービスプロバイダが 1 つのサブスクリプションを提供しますすべての購読者が同じコンテンツにアクセスできるのは、映画またはエピソードを視聴できます。

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "subscription",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
    },
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

多層サブスクリプション

階層型サブスクリプションモデルでは、サービスプロバイダは複数の（ゴールド、シルバー、 ブロンズ。上位の定期購入を利用しているユーザーは、すべてにアクセスできます下位層のコンテンツに配信します下位のティアのユーザーはアクセスできません。

次のシナリオを考えてみます。

Jane はゴールド階層に登録されています。お客様の利用資格エンドポイントは、次の entitlementId 識別子を返します。 <ph type="x-smartling-placeholder">
- example.com:bronze
- example.com:silver
- example.com:gold
John はブロンズ階層に登録しています。お客様の利用資格エンドポイントから次の entitlementId が返されます。 <ph type="x-smartling-placeholder">
- example.com:bronze
メディアアクションフィードで次の要件を満たしている必要があります。 <ph type="x-smartling-placeholder">
- Movie A には example.com:bronze が必要です。
- Movie B には example.com:silver が必要です。

このシナリオでは、Google は Jane に対して次のアクセスレベルを判断します。 John:

Jane と John はどちらも Movie A にアクセスできます。
Jane は Movie B にアクセスできますが、John はアクセスできません。

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "subscription",
    "requiresSubscription": {
      "@type": "MediaSubscription",
      "@id": "http://www.example.com/basic_subscription",
      "name": "Bronze",
      "commonTier": true
      ...
    },
    ...
  }
}

アドオンサブスクリプション

アドオンサブスクリプションモデルでは、サービスプロバイダが利用資格を拡大し、基本の定期購入にチャンネルを追加できます。ユーザーいくつでもチャンネルを追加できます。

次のシナリオを考えてみます。

Jane は PRO と Sportz のほかに Basic サブスクリプション利用資格エンドポイントは、次の entitlementId 識別子: <ph type="x-smartling-placeholder">
- example.com:basic
- example.com:pro
- example.com:sportz
John はベーシック サブスクリプションしか持っていません。お客様の利用資格エンドポイントから次の entitlementId が返されます。 <ph type="x-smartling-placeholder">
- example.com:basic
メディアアクションフィードで次の要件を満たしている必要があります。 <ph type="x-smartling-placeholder">
- Movie A には example.com:basic が必要です。
- Movie B には example.com:pro が必要です。

このシナリオでは、Google は Jane に対して次のアクセスレベルを判断します。 John:

Jane と John はどちらも Movie A にアクセスできます。
Jane は Movie B にアクセスできますが、John はアクセスできません。

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "subscription",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    "requiresSubscription": [
      {
          "@type": "MediaSubscription",
          "@id": "https://www.example.com/package/basic",
          "name": "Basic",
          "sameAs": "https://www.example.com/package/basic",
          "commonTier": true
        },
        {
          "@type": "MediaSubscription",
          "@id": "https://www.example.com/packages/basic/pro",
          "name": "PRO",
          "sameAs": "https://www.example.com/package/pro",
          "identifier": "example.com:pro",
          "commonTier": false
        },
        {
          "@type": "MediaSubscription",
          "@id": "https://www.example.com/package/sportz",
          "name": "Sportz",
          "sameAs": "https://www.example.com/package/sports",
          "identifier": "example.com:sportz",
          "commonTier": false
        }
    }
  }
}

1 回だけの購入

購入

終了後は、コンテンツを無期限に利用できる購入します

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "Example",
        "sameAs": "http://www.example.com/"
      }
    }
  }
}

category を purchase に設定する。
expectAcceptanceOf を含める価格を示す actionAccessibilityRequirement 購入します

レンタル

終了後は、コンテンツを一定時間利用できます。購入します

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "rental",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "Example",
        "sameAs": "http://www.example.com/"
      }
    }
  }
}

category を rental に設定する。
expectAcceptanceOf を含める価格を示す actionAccessibilityRequirement あります。

ライブテレビ

メディアアクションフィードでは、ライブテレビへのアクセスを制限できますチャンネルまたはイベントに基づいて次の 2 つの条件があります

ユーザーのデバイスの位置情報
テレビチャンネルへのアクセスを制限するには、ユーザーがあります。この条件は通常、ローカルブロードキャストに適用されます。テレビチャンネル。
ユーザーのアカウントのステータス
テレビチャンネルへのアクセスがユーザーのアカウントレベルの設定に依存している場合は、利用資格 ID を制限を表します。

この条件は通常、次のユースケースに適用されます。
- バンドル: 全国チャンネルは通常、ユーザーが登録するバンドルを選択できます。
- アドオン: 一部のプレミアムチャンネルでは、ユーザーが次の操作を選択的にチャンネル登録に他のチャンネルを追加する。
- 地域スポーツネットワーク（RSN）: 通常、RSN はユーザーの「自宅」に関連付けられたあります。ユーザーはコンテンツを視聴できますユーザーが「自宅」外に出張した場合でも RSN に表示させることができるあります。

サードパーティサブスクリプション

サードパーティの定期購入

登録者は別のサービスのコンテンツを利用できます。

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "externalsubscription"
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "requiresSubscription":{
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/faq",
      "name": "Example",
      "sameAs": "https://www.example.com/faq",
      "authenticator": {
        "@type": "Organization",
        "name": "TVE"
      }
    },
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

別のサービスであることを示す authenticator を追加サブスクライバーを認証しますたとえば、HBO GO にはケーブルプロバイダの契約期間です。

コモンティアパッケージ

コモンティアのコンテンツは、サブスクリプションパッケージ。共通階層は、category を持つすべてのコンテンツに適用されます。 /subscription。category プロパティの詳細については、以下をご覧ください。 [ペイウォールのタイプ] セクション

共通階層のパッケージが必要なのはなぜですか？

複数の Google プロダクトでテレビとユーザーに映画をおすすめする。には、Google 検索、Android TV、Google アシスタントが含まれます。ユーザーを設定するには料金に関する期待値について Google は、共通のティアで購読者数を減らすことができますまた Google は特定の定期購入パッケージに登録している購読者のみが利用できます。

Google は、 Entitlements API。この API により、Google は一般的でないタイトルを、それぞれの特定のできます。

共通階層のパッケージは、どのような場合に作成すればよいですか？

共通階層パッケージは、サービスですべての購読者に公開されますこれには、1 つのパッケージのみを提供するサービスも含まれます。複数のパッケージやアドオンを提供するサービスを提供しています

すべての購読者が利用できるコンテンツがないプロバイダは、一般的な階層のパッケージです相互に排他的なサービスを提供するサービスプロバイダがすべてのパッケージのコンテンツに再びアクセスできるようになります

一般的なティアの例

一般的な階層の例を次に示します。

段階的な定期購入

階層型サブスクリプションモデルでは、サービスプロバイダは複数のサブスクリプションを使用する ゴールド、シルバー、ブロンズなどのティアがあります。以下を持つユーザー上位階層のサブスクリプションは、下位階層のすべてのコンテンツにアクセスできます。ユーザー上位のサブスクリプションでは、上位のサブスクリプションのコンテンツにはアクセスできません。構成されます。次の図は、パッケージ構造の例を示しています。

ゴールドティアには、シルバーティアのすべてのコンテンツが含まれます。
ブロンズ階層がすべて含まれます。 — **図 5.** 定期購入パッケージの階層構造

次のコード例では、ブロンズパッケージが共通の階層です。これは、すべてのコンテンツにアクセスできます。

"requiresSubscription": [
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/bronze",
      "name": "Bronze",
      "sameAs": "https://www.example.com/package/bronze",
      "commonTier": true
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/silver",
      "name": "Silver",
      "sameAs": "https://www.example.com/package/silver",
      "identifier": "example.com:silver",
      "commonTier": false
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/gold",
      "name": "Gold",
      "sameAs": "https://www.example.com/package/gold",
      "identifier": "example.com:gold",
      "commonTier": false
    }
  ],

アドオン

アドオンサブスクリプションモデルでは、サービスプロバイダが基本の定期購入にチャンネルを追加することができます。次のユーザーとして追加可能: 柔軟にチャネルを選べます以下の画像は、このパッケージの例を示しています。構成します。

どのユーザーも Basic チャンネルから始めて、必要に応じて
PRO、Sportz、Moviemax チャンネルの任意の組み合わせ — **図 6.** アドオンサブスクリプションパッケージの構造

すべてのユーザーが利用できるチャンネルを運営していて、共通階層のパッケージと統合できます。

次のコードサンプルでは、すべての基本パッケージが共通の階層になっています。ユーザーはこのパッケージのすべてのコンテンツにアクセスできます。

"requiresSubscription": [
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/basic",
      "name": "Basic",
      "sameAs": "https://www.example.com/package/basic",
      "commonTier": true
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/packages/basic/pro",
      "name": "PRO",
      "sameAs": "https://www.example.com/package/pro",
      "identifier": "example.com:pro",
      "commonTier": false
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/sportz",
      "name": "Sportz",
      "sameAs": "https://www.example.com/package/sports",
      "identifier": "example.com:sportz",
      "commonTier": false
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/moviemax",
      "name": "Moviemax",
      "sameAs": "https://www.example.com/package/moviemax",
      "identifier": "example.com:moviemax",
      "commonTier": false
    }
  ],

コンテンツが交差するパッケージ

パッケージのコンテンツが交差するコンテンツモデルでは、プロバイダが他のパッケージのコンテンツを一部含むパッケージを販売している。「次の画像は、パッケージ構造の例を示しています。

パッケージ 1、2、3 の重複が
「Common Tier」というラベルが付けられています。 — **図 7.** コンテンツが交差するようなパッケージ構造

次のコードサンプルでは、プロバイダが 3 つのパッケージを提供しており、すべてのパッケージにまたがって一致します。この例では 4 番目のパッケージは必須です。すべてのコンテンツを含む必要があります。 3 つのパッケージで利用可能です

"requiresSubscription": [
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/1",
      "name": "Package 1",
      "sameAs": "https://www.example.com/package/1",
      "identifier": "example.com:package1",
      "commonTier": false
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/2",
      "name": "Package 2",
      "sameAs": "https://www.example.com/package/2",
      "identifier": "example.com:package2",
      "commonTier": false
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/3",
      "name": "Package 3",
      "sameAs": "https://www.example.com/package/3",
      "identifier": "example.com:package3",
      "commonTier": false
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/common",
      "name": "Common Tier Package",
      "sameAs": "https://www.example.com/package/common",
      "commonTier": true
    }
  ],

交差するコンテンツがないパッケージ

すべてのコンテンツパッケージが交差しないコンテンツモデルでは、プロバイダが他のパッケージのコンテンツを含むパッケージを販売している場合。「次の画像は、パッケージ構造の例を示しています。

パッケージ 1、2、3 は完全に独立しています。 — **図 8.** 交差しないパッケージ構造提供します。

次の例では、プロバイダがコンテンツのない 3 つのパッケージを提供しています。すべてのパッケージにまたがって一致する場合があります。共通階層パッケージは必要ありません。

"requiresSubscription": [
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/1",
      "name": "Package 1",
      "sameAs": "https://www.example.com/package/1",
      "identifier": "example.com:package1",
      "commonTier": false
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/2",
      "name": "Package 2",
      "sameAs": "https://www.example.com/package/2",
      "identifier": "example.com:package2",
      "commonTier": false
    },
    {
      "@type": "MediaSubscription",
      "@id": "https://www.example.com/package/3",
      "name": "Package 3",
      "sameAs": "https://www.example.com/package/3",
      "identifier": "example.com:package3",
      "commonTier": false
    }
  ],

登録情報のエンドポイント

このセクションの情報を使用して、HTTPS エンドポイントをホストアクセスできるようになります。

前提条件

開始する前に、ご使用のサービスが Google での OAuth 2.0 フロー

リクエスト

ユーザーの利用資格を受け取るために、Google はユーザーの OAuth トークンで識別されます。エンドポイントでは、その OAuth に基づいてユーザーを識別する必要があります。あります。次の例をご覧ください。

GET /resource HTTP/1.1
Host: server.example.com
Authorization: Bearer <OAuthToken>

レスポンス

エンドポイントでは、次のプロパティを指定したレスポンスを返す必要があります。

プロパティ
`subscription`	必須これはルートレスポンス内のフィールドです。
`subscription.type`	必須このプロパティには以下の値を指定できます。 `ActiveSubscription`: ユーザーに有効なサブスクリプションがあります渡します。 `ActiveTrial`: ユーザーに有効なトライアル期間があります接続します。 `InactiveSubscription`: ユーザーには定期購入または有効なトライアルです。
`subscription.expiration_date`	任意このエンタイトルメントの有効期限（ ISO 8601 形式タイムゾーンが含まれます。詳しくは、有効期限。
`entitlements`	任意このルートプロパティには、ルートモジュールで使用されている `entitlementId` 値が防ぐことができます。
`entitlements.entitlement`	ストリーミングカタログへのアクセスの種類が異なる場合は必須定期購入のタイプに応じて異なります。このプロパティには `entitlementId` が含まれます。詳細情報詳しくは、利用資格 ID。
`entitlements.expiration_date`	任意このサブスクリプションの有効期限 ISO 8601 形式タイムゾーンが含まれます。詳しくは、有効期限。

有効期限

エンドポイントレスポンスには有効期限を扱う 2 つのプロパティがある日付: subscription.expiration_date、entitlements.expiration_date。マイページいずれか一方を含めることも、どちらも指定せずに、両方を含めることはできません。どちらを使用するかは、選択できます

サブスクリプションモデル

ストリーミングカタログへのアクセスは、すべての定期購入者が同じです。 entitlements を指定する必要がないためプロパティには subscription.expiration_date を指定します。

サブスクリプションモデル
ストリーミングカタログへのアクセスは、すべての定期購入者が同じです。	`entitlements` を指定する必要がないためプロパティには `subscription.expiration_date` を指定します。
ストリーミングカタログへのアクセスは、表示されます。	サブスクリプションモデルに複数の階層やアドオンがあり、時間が経つと期限切れになる場合は、次のいずれかを行います。すべての `entitlements.entitlement` 値が `subscription.expiration_date` を指定します。一部の `entitlements.entitlement` 値が `entitlements.expiration_date` を指定します。

ストリーミングカタログへのアクセスは、表示されます。

サブスクリプションモデルに複数の階層やアドオンがあり、時間が経つと期限切れになる場合は、次のいずれかを行います。

すべての entitlements.entitlement 値が subscription.expiration_date を指定します。
一部の entitlements.entitlement 値が entitlements.expiration_date を指定します。

回答例

定期購入のステータスに応じたレスポンスの例を次に示します。

有効な定期購入
有効期限のある有効なサブスクリプション
定期購入なし
複数のティアまたはアドオンへの有効な定期購入

有効な定期購入

有効な定期購入

ユーザーに example.com の有効なサブスクリプションがあります。このすべてのサブスクライバーがストリーミングカタログ全体にアクセスできるすべての購読プランがあります

{
  "subscription" : {
    "type": "ActiveSubscription",
  }
}

有効期限のある有効なサブスクリプション

有効期限のある有効なサブスクリプション

ユーザーに example.com の有効な定期購入があり、かつサブスクリプションに有効期限が設定されています。この場合、すべてのサブスクライバーにサブスクリプションに関係なく、ストリーミングカタログ全体にアクセスできますあります。

{
  "subscription" : {
    "type": "ActiveSubscription",
    "expiration_date": "2019-11-10T10:00:00Z"
  }
}

定期購入なし

定期購入なし

ユーザーに example.comexample.com の定期購入がない。

{
  "subscription" : {
    "type": "InactiveSubscription"
  }
}

複数のティアまたはアドオンへの有効な定期購入

複数のティアまたはアドオンの有効な定期購入

ユーザーは特定の日付まで example.com:premium を定期購入しています。

{
  "subscription" : {
    "type": "ActiveSubscription",
  }
  "entitlements": [
    {
      "entitlement": "example.com:premium",
      "expiration": "2019-11-10T10:00:00Z"
    }
  ]
}

</ph> 注: リクエストのユーザーが存在しない場合は、エンドポイントで次の操作を行う必要があります。 404 エラーを返す。さらに、システムからの空のレスポンスもエンドポイントは無効とみなされ、無視されます。

レート上限

Google では最大 6 時間ごとにユーザーの利用資格情報を更新します。宛先最大秒間クエリ数（QPS）を平滑化すると、Google がエンドポイントに均等に分散されます。したがってエンドポイントの QPS は次の式になります。

予想される平均 QPS = <ユーザーの総数> / 21,600 秒（6 時間 x 60 分 x 60 秒）

多数のユーザーをサポートする場合は、Google が 6 時間の間隔を調整します。必要に応じて、構成について Google にお問い合わせください。

Google に問い合わせ

エンドポイントの準備が整ったら、Google にエンドポイントの URL を通知してください。

アクションアクセス指定プロパティ

詳しくは、参照用のアクションアクセス仕様のプロパティセクション情報です。