Требования к доступу

Пользователи предпочитают смотреть или слушать контент, к которому у них уже есть доступ, например, контент по существующей подписке. Если Google знает, к какому контенту пользователь может получить доступ в вашем приложении или на вашей платформе, то Google может обеспечить более релевантный опыт на всех платформах Google и направить пользователя именно к этому контенту.

Рисунок 1. Требования к доступу помогают вашим подписчикам получать доступ к контенту в вашем приложении или на платформе.

Определите требования к доступу к контенту.

Необходимо определить требования к доступу для каждого пакета контента в вашем каталоге. При этом следует рассмотреть следующие вопросы:

• Нужно ли пользователям входить в ваше приложение или на вашу платформу, чтобы получить доступ к контенту?

• Нужна ли пользователям подписка?

  Смотрите только действия:

  • Нужна ли пользователям подписка от стороннего поставщика услуг?
  • Предлагаете ли вы многоуровневые, пакетные или дополнительные подписки?

• Только для просмотра действий: Нужно ли пользователям арендовать или покупать контент?

• Меняются ли требования к доступу со временем?

• Зависят ли требования к доступу от местоположения устройства?

типы ограничений доступа

Существует два вида ограничений доступа:

• тип платного доступа
• Географическая область

тип платного доступа

Вы можете ограничить доступ к контенту, указав тип платного доступа. В таблице ниже подробно описаны различные типы платного доступа:

тип платного доступа	Пример	Категория
Покупка или регистрация не требуются.	Треск	nologinrequired
Пользователь должен быть авторизован, но платная подписка не требуется.	Vudu (AVOD)	free
У пользователя должна быть активная подписка. Доступ не зависит от уровня подписки.	Netflix	subscription Примечание: Требуется разметка общего уровня .
У пользователя должна быть активная подписка. Доступ зависит от выбранного уровня подписки.	Hulu (дополнения)	subscription Примечание: Укажите набор идентификаторов прав доступа, необходимых для доступа к этому контенту, с помощью MediaSubscription.identifier . Дополнительную информацию см. в разделе «Идентификатор прав доступа» . Также может потребоваться общая разметка уровня подписки.
Контент доступен в течение ограниченного времени после покупки.	Вуду	rental
Контент доступен неограниченное время после покупки.	Вуду	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"
    }
  },
  ...
}

Географическая область

Необходимо указать географические регионы, где доступен контент. Используйте одно или оба из следующих свойств:

• Свойство eligibleRegion объекта спецификации доступа к действию . Это свойство обязательно для использования.
• Свойство ineligibleRegion объекта спецификации доступа к действию .

Пользователь может получить доступ к контенту, если местоположение устройства находится в пределах любого региона, указанного в eligibleRegion , и не находится в пределах любого региона, указанного в ineligibleRegion .

Свойства eligibleRegion и ineligibleRegion допускают следующие значения:

• Список Country , City и State .
• Объект GeoShape . Подробные требования см. в разделе « Свойства GeoShape .
• Список объектов GeoShape .

Если контент доступен во всем мире, используйте следующее специальное значение для eligibleRegion :

"eligibleRegion": "EARTH",

Варианты использования подходящего региона

Ниже приведены примеры использования свойства eligibleRegion :

• Пример 1: eligibleRegion со списком стран.
• Пример 2: eligibleRegion с объектом GeoShape , содержащим список почтовых индексов.
• Пример 3: eligibleRegion с объектом GeoShape , содержащим список кодов зон сортировки (FSA).
• Пример 4: eligibleRegion с объектом GeoShape , содержащим идентификатор DMA.
• Пример 5: eligibleRegion со списком объектов GeoShape . Каждый объект содержит идентификатор DMA.
• Пример 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 , содержащим список кодов зон сортировки (FSA):

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

Пример 4

eligibleRegion с объектом GeoShape , содержащим идентификатор DMA:

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

Пример 5

eligibleRegion содержит список объектов GeoShape . Каждый объект имеет идентификатор DMA:

"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
  },
  "additionalProperty": {
      "@type": "PropertyValue",
      "name": "DisplaySubscriptionIdentifier",
      "value": "http://www.example.com/local_tv_network/subscription"
  },
 "eligibleRegion":   {
      "@type": "Country",
      "name": "US"
    },
  "ineligibleRegion": {
    "@type": "GeoShape",
    "@id": "http://example.com/area1",
    "addressCountry": "US",
    "postalCode": [
      "94118",
      "94119"
    ]
  }
}

Идентификатор права доступа

Идентификатор права доступа, entitlementId , представляет собой строку, обозначающую доступ к группе контента в вашем медиакаталоге. Чтобы определить, имеет ли пользователь доступ к вашему контенту, Google выполняет следующие действия:

1. Мы выполняем вызов API к вашей конечной точке Entitlements , чтобы получить идентификаторы прав пользователя.
2. Мы получаем необходимые идентификаторы прав доступа к контенту из вашего фида Media Actions.
3. Мы сопоставляем entitlementId пользователя со свойством identifier объекта подписки на медиаконтент в вашем ленте. Если совпадает хотя бы один entitlementId , мы определяем, что пользователь может получить доступ к контенту.

Примечание: Ваш сервис должен содержать HTTPS-конечную точку , которая возвращает идентификаторы прав пользователя.

Рисунок 2. Один из идентификаторов прав доступа пользователя совпадает с требуемым идентификатором прав доступа к контенту.

Google рекомендует использовать следующий синтаксис для entitlementId :

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

Примеры синтаксиса:

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

Пример идентификатора права доступа

В ленте MediaExampleCompany указано, что Movie XYZ требуется entitlementId example.com:basic , как показано ниже:

{
  "@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
        ...
      },
      "additionalProperty": {
        "@type": "PropertyValue",
        "name": "DisplaySubscriptionIdentifier",
        "value": "http://www.example.com/basic_subscription"
      },
      ...
    }
  },
  ...
}

Типичные сценарии использования доступа

Ниже приведены типичные сценарии использования доступа:

• Бесплатно (регистрация не требуется): контент доступен без регистрации, подписки или покупки.
• Бесплатно (требуется авторизация): Для доступа к контенту требуется авторизация, но подписка не требуется.
• Одноуровневая подписка: Для доступа к контенту требуется подписка. Все подписчики могут получить доступ к одному и тому же контенту, будь то фильмы или эпизоды, независимо от выбранного ими пакета подписки.
• Многоуровневая подписка: Для доступа к контенту требуется подписка. Подписчики могут получать доступ к различному контенту, будь то фильмы или эпизоды, в зависимости от выбранного уровня подписки. Например, Silver против Gold .
• Дополнительная подписка: Для доступа к контенту требуется подписка. Подписчики могут добавить премиум-контент к своей обычной подписке.
• Единовременная покупка: контент можно приобрести, после чего пользователь может получить к нему неограниченный доступ.
• Прямая трансляция: Подписка включает доступ к местным, национальным и премиум-каналам.
• Подписка от стороннего поставщика: для доступа к контенту пользователю необходимо войти в систему через своего кабельного провайдера.

Бесплатно (регистрация не требуется)

Вход в систему не требуется.

Контент доступен без регистрации и подписки.

{
  "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"
    },
    "additionalProperty": {
      "@type": "PropertyValue",
      "name": "DisplaySubscriptionIdentifier",
      "value": "http://www.example.com/example_package"
    },
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

Многоуровневая подписка

В многоуровневой модели подписки у поставщика услуг есть несколько уровней подписки, таких как Gold , Silver и Bronze . Пользователи с подпиской более высокого уровня имеют доступ ко всему контенту более низкого уровня. Однако пользователи с подпиской более низкого уровня не имеют доступа к контенту более высокого уровня.

Рисунок 3. Многоуровневая модель подписки и представление прав доступа к ней.

Рассмотрим следующий сценарий:

• Джейн подписана на тарифный план Gold . Ваша конечная точка для управления правами доступа возвращает следующие идентификаторы entitlementId :
  • example.com:bronze
  • example.com:silver
  • example.com:gold
• Джон подписан на тарифный план Bronze . Ваша конечная точка для управления правами доступа возвращает следующий entitlementId :
  • example.com:bronze
• В вашем ленте Media Actions должны быть соблюдены следующие требования:
  • Для просмотра фильма A требуется example.com:bronze .
  • Для просмотра фильма B требуется example.com:silver .

В этом сценарии Google определяет следующие уровни доступа для Джейн и Джона:

• И Джейн, и Джон имеют доступ к фильму А.
• У Джейн есть доступ к фильму B , а у Джона — нет.

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

Дополнительная подписка

В модели подписки с дополнительными услугами поставщик услуг позволяет пользователям расширять свои права и добавлять каналы к базовой подписке. Пользователи могут добавить столько каналов, сколько захотят.

Рисунок 4. Модель подписки на дополнительные услуги и представление прав доступа к ним.

Рассмотрим следующий сценарий:

• Помимо базовой подписки, у Джейн есть PRO и Sportz . Ваша конечная точка для получения прав доступа возвращает следующие идентификаторы entitlementId :
  • example.com:basic
  • example.com:pro
  • example.com:sportz
• У Джона только базовая подписка. Ваша конечная точка для управления правами доступа возвращает следующий entitlementId :
  • example.com:basic
• В вашем ленте Media Actions должны быть соблюдены следующие требования:
  • Для просмотра фильма A требуется example.com:basic .
  • Для просмотра фильма B требуется example.com:pro .

В этом сценарии Google определяет следующие уровни доступа для Джейн и Джона:

• И Джейн, и Джон имеют доступ к фильму А.
• У Джейн есть доступ к фильму 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
        }
    ],
      "additionalProperty": {
        "@type": "PropertyValue",
        "name": "DisplaySubscriptionIdentifier",
        "value": "http://www.example.com/package/basic"
      },
    }
  }
}

Единоразовая покупка

Покупка

Контент доступен неограниченное время после покупки.

{
  "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 , чтобы указать цену аренды.

Прямая трансляция ТВ

В ленте «Действия с медиаконтентом» можно ограничить доступ к телеканалу или событию в прямом эфире на основе следующих двух условий пользователя:

• Местоположение устройства пользователя

  Чтобы ограничить доступ к телеканалу, укажите регион, где пользователи имеют к нему доступ. Это условие обычно применяется к местным телеканалам.

• Статус учетной записи пользователя

  Если доступ к телеканалу зависит от настроек учетной записи пользователя, используйте идентификаторы прав доступа для обозначения ограничения.

  Это условие обычно применяется в следующих случаях:

  • Пакетные предложения: Национальные каналы часто входят в пакеты, и пользователи сами выбирают, на какой пакет они хотят подписаться.
  • Дополнительно: Для некоторых платных каналов пользователям необходимо выборочно добавлять дополнительные каналы к своей подписке.
  • Региональные спортивные сети (РСН): РСН обычно связаны с местоположением «дома» пользователя. Пользователи могут смотреть контент РСН, даже находясь за пределами своего «дома».

Подписка от стороннего поставщика

Подписка от стороннего поставщика

Подписчикам этот контент доступен через другой сервис.

{
  "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"
      }
    },
    "additionalProperty": {
      "@type": "PropertyValue",
      "name": "DisplaySubscriptionIdentifier",
      "value": "http://www.example.com/faq"
     },
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

• Добавьте authenticator , чтобы указать, что аутентификацию подписчиков выполняет другой сервис. Например, для HBO GO требуется подписка от кабельного провайдера.

Пакеты стандартного уровня

Контент общего уровня доступен всем подписчикам независимо от выбранного ими тарифного плана. Общий уровень применяется ко всему контенту, относящемуся к category subscription . Для получения дополнительной информации о category см. раздел «Тип платного доступа» .

Примечание: стандартный уровень не обязательно должен соответствовать пакету услуг, который пользователь может фактически приобрести.

Почему требуется пакет услуг стандартного уровня?

На нескольких платформах Google пользователям предлагаются рекомендации по телепередачам и фильмам. Чтобы сформировать у пользователей представление о стоимости, Google должен понимать, какой контент доступен всем подписчикам, использующим общий тарифный план. Google также должен понимать, какой контент доступен подписчикам с определенными пакетами подписки.

Google рекомендует контент, доступный на общем уровне подписки, если вы не поддерживаете API управления правами доступа . Этот API позволяет Google понять, к каким контентам, не входящим в общий уровень подписки, может получить доступ каждый конкретный пользователь.

Когда следует создавать пакет общего уровня?

Единый тарифный план необходим, если ваш сервис предлагает контент, доступный всем подписчикам. Это включает в себя как сервисы, предлагающие только один пакет, так и сервисы, предлагающие несколько пакетов или дополнительных услуг.

Провайдерам, у которых контент недоступен всем абонентам, не нужно создавать единый тарифный план. Примером могут служить провайдеры, предоставляющие взаимоисключающий контент во всех своих пакетах.

Примеры общего уровня

Ниже приведены примеры распространенного уровня.

Многоуровневая подписка

В многоуровневой модели подписки поставщик услуг предлагает несколько уровней подписки, таких как Gold , Silver и Bronze . Пользователи с подпиской более высокого уровня имеют доступ ко всему контенту более низких уровней. Пользователи с подпиской более низкого уровня не имеют доступа к контенту более высокого уровня. На следующем изображении представлен пример структуры пакета.

Рисунок 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
    }
  ],

Дополнительные опции

В модели подписки с дополнительными услугами поставщик услуг позволяет пользователям расширять свои права и добавлять каналы к базовой подписке. Пользователи могут добавить столько каналов, сколько захотят. На следующем изображении представлен пример структуры пакета.

Рисунок 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
    }
  ],

Пакеты с содержимым, которое пересекается

В контентной модели, где содержимое пакетов пересекается, поставщик услуг продает пакеты, которые включают в себя часть содержимого других пакетов. На следующем изображении представлен пример структуры пакета.

Рисунок 7. Структура упаковки с пересекающимся содержимым.

В приведенном ниже примере кода провайдер предлагает три пакета, контент которых пересекается во всех трех пакетах. В этом случае требуется четвертый пакет, представляющий собой общий уровень. Он должен включать весь контент, доступный во всех трех пакетах.

"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
    }
  ],

Пакеты, содержимое которых не пересекается

В контентной модели, где все контентные пакеты не пересекаются, поставщик услуг продает пакеты, которые не содержат контента из других пакетов. На следующем изображении показан пример структуры пакета.

Рисунок 8. Структура упаковки без пересекающегося содержимого.

В следующем примере провайдер предлагает три пакета услуг, контент которых не пересекается ни в одном из них. Общий тарифный план не требуется.

Примечание: Для пакетов, не входящих в общий уровень обслуживания, обязательно установите свойство `commonTier` в значение `false`.

"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
    }
  ],

Примечание: Вы можете использовать схему additionalProperty , чтобы сообщить Google, какой пакет вы хотите отобразить.

Конечная точка прав доступа

Используйте информацию из этого раздела для размещения HTTPS-конечной точки, которая возвращает права доступа, связанные с пользователем.

Предварительное условие

Прежде чем начать, убедитесь, что ваш сервис поддерживает протокол OAuth 2.0 от Google.

Запрос

Для получения прав пользователя 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 ). Для получения дополнительной информации см. раздел «Идентификатор права доступа» .
entitlements.expiration_date	Необязательный Дата истечения срока действия данной подписки в формате ISO 8601 , включая часовой пояс. Для получения более подробной информации см. раздел «Даты истечения срока действия» .

Сроки годности

В ответе конечной точки есть два свойства, отвечающие за даты истечения срока действия: subscription.expiration_date и entitlements.expiration_date . Вы можете указать одно из них или ни одно, но не оба. Какой из них использовать, зависит от вашей модели подписки.

Модель подписки
Доступ к вашему каталогу потокового контента одинаков для всех подписчиков.	Поскольку указывать свойство entitlements не требуется, укажите subscription.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.com .

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

Активные подписки на несколько уровней или дополнительных пакетов.

Активные подписки на несколько уровней или дополнительных пакетов.

У пользователя есть подписка на example.com:premium до определенной даты.

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

Примечание: Если пользователь из запроса не существует, ваш конечный пункт должен вернуть ошибку 404 Кроме того, пустой ответ от вашего конечного пункта считается недействительным и игнорируется.

Лимит скорости

Google обновляет информацию о правах пользователя каждые шесть часов. Для сглаживания максимального количества запросов в секунду (QPS) Google равномерно распределяет запросы к вашей конечной точке во времени. Таким образом, вы можете оценить ожидаемое среднее количество запросов в секунду для вашей конечной точки по следующей формуле:

Ожидаемое среднее время отклика в секунду (QPS) = <общее количество пользователей> / 21 600 секунд (6 часов x 60 минут x 60 секунд)

Если вы обслуживаете большое количество пользователей, Google может скорректировать 6-часовой интервал. При необходимости свяжитесь с Google для обсуждения настроек.

Связаться с Google

Когда ваша конечная точка будет готова, свяжитесь с Google, чтобы сообщить URL-адрес конечной точки.

Свойства спецификации доступа к действию

Для получения справочной информации см. раздел « Свойства спецификации доступа к действию» .