存取權需求

範例 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 物件，該物件會 包含向前分類區 (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 物件清單。 每個都含有一個指定行銷區域 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"
    ]
  }
}

免費 (不需登入)

不需登入

不需登入或訂閱即可使用。

{
  "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」。

單層訂閱方案

在單層訂閱模式中，服務供應商有 訂閱級別所有訂閱者都能存取相同的內容 電影或劇集。

{
  "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"
    }
  }
}

多層訂閱方案

在分級式訂閱模式中，服務供應商有多個 訂閱層級，例如「Gold」、「Silver」和 銅級。訂閱較高層級的使用者可以存取所有 較低層級的內容不過，使用者層級較低的使用者 訂閱無法存取較高層級的內容。

請參考下列情境：

• Jane 會訂閱「Gold」等級。您的授權 端點會傳回下列 entitlementId ID：
  • example.com:bronze
  • example.com:silver
  • example.com:gold
• John 訂閱了銅級級別。您的授權 端點會傳回下列 entitlementId：
  • example.com:bronze
• 媒體動作動態饋給必須符合下列規定：
  • 電影 A 需要 example.com:bronze。
  • 電影 B 需要 example.com:silver。

在這個情境中，Google 會為 Jane 決定下列存取層級 和 John：

• Jane 和 John 都可存取電影 A。
• 小珍可以存取「電影 B」，但大明沒有。

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

加購訂閱項目

在外掛程式訂閱模式中，服務供應商可讓使用者 擴充授權，並將頻道加入基本訂閱項目。位使用者 則可加入任意數量的頻道

請參考下列情境：

• 除了 PRO 和 Sportz 以外， 基本訂閱。您的授權端點會傳回 以下 entitlementId ID：
  • example.com:basic
  • example.com:pro
  • example.com:sportz
• John 只有「基本」訂閱方案。您的授權 端點會傳回下列 entitlementId：
  • example.com:basic
• 媒體動作動態饋給必須符合下列規定：
  • 電影 A 需要 example.com:basic。
  • 電影 B 需要 example.com:pro。

在這個情境中，Google 會為 Jane 決定下列存取層級 和 John：

• Jane 和 John 都可存取電影 A。
• 小珍可以存取「電影 B」，但大明沒有。

{
  "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
        }
    }
  }
}

一次性消費

購買

內容在 購買。

{
  "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 代表 租借。

電視直播

在媒體動作動態消息中，你可以限制電視直播內容的存取權 頻道或 事件 (根據 有兩個使用者條件：

• 使用者裝置位置

  如要限制電視頻道的存取權，請指定使用者所在區域 就能存取該資源這個條件通常適用於當地廣播 電視頻道。

• 使用者的帳戶狀態

  如果電視頻道的存取權取決於使用者的帳戶層級設定， 使用 授權 ID 相關限制

  這種條件通常適用於以下用途：

  • 套裝組合：全國性頻道通常包含在 套裝組合和使用者選擇要訂閱的套裝組合。
  • 加購內容：部分付費頻道使用者必須 選擇性地將額外頻道加入他們的訂閱項目中。
  • 區域運動網路 (RSN)：RSN 通常 與使用者的「住家」相關聯或 HTTP/HTTPS 位置使用者可以觀看內容 順帶一提或 HTTP/HTTPS 位置

第三方訂閱

第三方訂閱服務

訂閱者可透過其他服務存取該內容。

{
  "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 需要 訂閱有線電視服務供應商

有效訂閱內容

有效訂閱方案

使用者已訂閱 example.com。在本 所有訂閱者都能存取你的所有串流目錄 以及各種訂閱類型

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

設有到期日的有效訂閱項目

有效訂閱方案，有到期日

使用者已訂閱 example.com， 訂閱項目設有到期日。在這個範例中，所有訂閱者 存取所有串流目錄 (不限訂閱方案) 類型。

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

沒有訂閱項目

無訂閱

使用者未訂閱 example.com。

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

多個訂閱等級或加購內容的有效訂閱

多個訂閱等級或加購內容的有效訂閱項目

使用者在特定日期前訂閱了 example.com:premium。

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