उपयोगकर्ता ऐसे कॉन्टेंट को देखना या सुनना पसंद करते हैं जिसे वे पहले से ही ऐक्सेस कर सकते हैं, जैसे कि कॉन्टेंट मैनेजर बना सकता है. अगर Google को पता हो कि उपयोगकर्ता किस तरह के कॉन्टेंट को ऐक्सेस कर सकता है का इस्तेमाल किया जा सकता है, तो Google एक बेहतर खोज नतीजा तैयार कर सकता है या रिस्पॉन्स के तौर पर, लोगों को उस कॉन्टेंट पर ले जाएं.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-entitlements-4.png?authuser=7&hl=hi)
कॉन्टेंट ऐक्सेस करने से जुड़ी ज़रूरी शर्तों के बारे में बताएं
आपको अपने कैटलॉग. ऐसा करते समय, इन बातों का ध्यान रखें:
- क्या कॉन्टेंट को ऐक्सेस करने के लिए, लोगों को आपके ऐप्लिकेशन या प्लैटफ़ॉर्म में लॉग इन करना ज़रूरी है?
क्या उपयोगकर्ताओं को सदस्यता की ज़रूरत होती है?
सिर्फ़ देखने की कार्रवाइयां:
- क्या उपयोगकर्ताओं को, सेवा देने वाली किसी बाहरी कंपनी से सदस्यता लेनी होती है?
- क्या आपका कारोबार अलग-अलग टीयर वाली, कई तरह के पैकेज या ऐड-ऑन वाली सदस्यता ऑफ़र करता है?
स्मार्टवॉच की कार्रवाइयों के लिए: क्या उपयोगकर्ता को कॉन्टेंट किराये पर लेना या खरीदना होगा?
क्या समय के साथ ऐक्सेस की ज़रूरी शर्तों में बदलाव होता है?
क्या ऐक्सेस की ज़रूरी शर्त, डिवाइस की जगह के हिसाब से तय होती है?
ऐक्सेस से जुड़ी पाबंदियां
ऐक्सेस से जुड़ी दो तरह की पाबंदियां होती हैं:
पेवॉल का टाइप
पेवॉल के हिसाब से कॉन्टेंट के ऐक्सेस पर पाबंदी लगाई जा सकती है. नीचे दी गई टेबल इसमें अलग-अलग तरह के पेवॉल की जानकारी दी गई है:
पेवॉल का टाइप | उदाहरण | कैटगरी |
---|---|---|
इसके लिए, किसी खरीदारी या लॉगिन की ज़रूरत नहीं है. | Crackle | nologinrequired |
उपयोगकर्ता ने लॉग इन किया होना चाहिए, लेकिन उसे पैसे देकर ली जाने वाली सदस्यता की ज़रूरत नहीं है. | वूडू (एवीओडी) | free |
उपयोगकर्ता के पास चालू सदस्यता होनी चाहिए. ऐक्सेस स्वतंत्र है . | Netflix |
|
उपयोगकर्ता के पास चालू सदस्यता होनी चाहिए. ऐक्सेस इन बातों पर निर्भर करता है: उसे कैसे चुनें. | Hulu (ऐड-ऑन) |
|
इस अवधि के बाद, कॉन्टेंट सीमित समय के लिए उपलब्ध होता है खरीदारी. | 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"
}
},
...
}
भौगोलिक इलाका
आपको उन भौगोलिक क्षेत्रों की जानकारी देनी होगी जहां कॉन्टेंट उपलब्ध है. इनमें से किसी एक का इस्तेमाल करें या नीचे दी गई दोनों प्रॉपर्टी:
- किसी खास डोमेन की
eligibleRegion
प्रॉपर्टी कार्रवाई ऐक्सेस करने के बारे में खास जानकारी ऑब्जेक्ट है. यह प्रॉपर्टी ज़रूरी है. - किसी खास डोमेन की
ineligibleRegion
प्रॉपर्टी कार्रवाई ऐक्सेस करने के बारे में खास जानकारी ऑब्जेक्ट है.
अगर डिवाइस की जगह की जानकारी किसी भी इलाके में है, तो वह कॉन्टेंट ऐक्सेस कर सकता है
eligibleRegion
में बताया गया है और ऐसे किसी भी क्षेत्र में नहीं है जहां इसके बारे में बताया गया है
ineligibleRegion
.
eligibleRegion
और ineligibleRegion
प्रॉपर्टी में इनकी अनुमति होती है
मान:
- इसकी सूची
Country
City
, औरState
. - ऐप्लिकेशन
GeoShape
ऑब्जेक्ट है. ज़्यादा जानकारी के लिए,GeoShape
प्रॉपर्टी सेक्शन देखें. GeoShape
ऑब्जेक्ट की सूची.
अगर कॉन्टेंट दुनिया भर में उपलब्ध है, तो इन चीज़ों के लिए नीचे दी गई खास वैल्यू का इस्तेमाल करें
eligibleRegion
:
"eligibleRegion": "EARTH",
मंज़ूरी देने वाले इलाके के इस्तेमाल के उदाहरण
यहां eligibleRegion
प्रॉपर्टी के इस्तेमाल के उदाहरण दिए गए हैं:
- पहला उदाहरण: देशों की सूची के साथ
eligibleRegion
. - दूसरा उदाहरण:
GeoShape
ऑब्जेक्ट के साथeligibleRegion
पिन कोड की एक सूची शामिल है. - तीसरा उदाहरण:
GeoShape
ऑब्जेक्ट वालाeligibleRegion
जो फ़ॉरवर्ड सोरटेशन एरिया (एफ़एसए) कोड की सूची मौजूद है. - उदाहरण 4:
GeoShape
ऑब्जेक्ट वालाeligibleRegion
जो डीएमए आईडी मौजूद होता है. - उदाहरण 5:
GeoShape
ऑब्जेक्ट की सूची के साथeligibleRegion
. हर एक में एक डीएमए आईडी होता है. - छठा उदाहरण: ब्लॉक किए गए पिन कोड वाले
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
GeoShape
ऑब्जेक्ट के साथ eligibleRegion
ज़िप कोड की एक सूची शामिल है:
"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
GeoShape
ऑब्जेक्ट के साथ eligibleRegion
फ़ॉरवर्ड सोरटेशन एरिया (एफ़एसए) कोड की सूची मौजूद है:
"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
GeoShape
ऑब्जेक्ट के साथ eligibleRegion
डीएमए आईडी मौजूद है:
"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
GeoShape
ऑब्जेक्ट की सूची के साथ eligibleRegion
.
हर एक में एक डीएमए आईडी होता है:
"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" } } ] }
छठा उदाहरण
ब्लॉक आउट किए गए पिन कोड वाले 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" ] } }
एनटाइटलमेंट आइडेंटिफ़ायर
एनटाइटलमेंट आइडेंटिफ़ायर entitlementId
, ऐसी स्ट्रिंग के बारे में बताता है जो
आपके मीडिया कैटलॉग में कॉन्टेंट के किसी ग्रुप को ऐक्सेस करने की अनुमति देती है. यह पता लगाने के लिए कि उपयोगकर्ता
अगर आपके पास आपके कॉन्टेंट का ऐक्सेस है, तो Google यह तरीका अपनाता है:
- हम आपके उपयोगकर्ता की जानकारी पाने के लिए, एनटाइटलमेंट एंडपॉइंट एनटाइटलमेंट आइडेंटिफ़ायर.
- हम आपके मीडिया से, कॉन्टेंट के लिए ज़रूरी एनटाइटलमेंट आइडेंटिफ़ायर का पता लगाते हैं ऐक्शन फ़ीड.
- हम उपयोगकर्ता के
entitlementId
का मिलानidentifier
प्रॉपर्टी आपके फ़ीड में मीडिया सदस्यता ऑब्जेक्ट. अगर कम से कम एकentitlementId
मिलान करता है, तो हम निर्धारित करते हैं कि उपयोगकर्ता कॉन्टेंट.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-entitlements-5.png?authuser=7&hl=hi)
Google का सुझाव है कि आप entitlementId
के लिए इस सिंटैक्स का इस्तेमाल करें:
<domain name> + colon (:) + <access level to content>
सिंटैक्स के उदाहरण:
example.com:basic
example.com:premium
example.com:sports
एनटाइटलमेंट आइडेंटिफ़ायर का उदाहरण
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 ... }, ... } }, ... }
ऐक्सेस के इस्तेमाल के सामान्य उदाहरण
यहां ऐक्सेस के सामान्य उदाहरण दिए गए हैं:
- मुफ़्त (लॉगिन की ज़रूरत नहीं है): कॉन्टेंट लॉगिन, सदस्यता या खरीदारी के बिना उपलब्ध है.
- मुफ़्त (लॉगिन करना ज़रूरी है): कॉन्टेंट के लिए उपयोगकर्ताओं को लॉग इन करना ज़रूरी है. हालांकि, इसके लिए सदस्यता की ज़रूरत नहीं होती.
- एक टीयर वाली सदस्यता: इस कॉन्टेंट के लिए सदस्यता लेना ज़रूरी है. सभी सदस्य एक ही फ़ाइल का इस्तेमाल कर सकते हैं फ़िल्में या एपिसोड, चाहे उनकी सदस्यता कोई भी हो पैकेज.
- मल्टी-टियर सदस्यता: कॉन्टेंट के लिए सदस्यता ज़रूरी है. सदस्य, अलग-अलग तरह का कॉन्टेंट ऐक्सेस कर सकते हैं, फ़िल्में या एपिसोड, उनकी सदस्यता के टियर के हिसाब से उपलब्ध होंगे. उदाहरण के लिए, सिल्वर बनाम गोल्ड.
- ऐड-ऑन सदस्यता: कॉन्टेंट इसके लिए सदस्यता लेना ज़रूरी है. सदस्य, प्रीमियम कॉन्टेंट को अपने सबसे ऊपर जोड़ सकते हैं सामान्य सदस्यता.
- एक बार खरीदना: कॉन्टेंट में ये काम किए जा सकते हैं खरीदा हो, जिसके बाद उपयोगकर्ता इसे हमेशा के लिए ऐक्सेस कर सकता है.
- लाइव टीवी: सदस्यता में ये सुविधाएं शामिल हैं लोकल, नैशनल, और प्रीमियम चैनलों पर भेज सकते हैं.
- तीसरे पक्ष की सदस्यता: इस कॉन्टेंट के लिए उपयोगकर्ता को, केबल की सेवा देने वाली कंपनी के प्लैटफ़ॉर्म पर लॉग इन करना होगा.
मुफ़्त (लॉगिन की ज़रूरत नहीं है)
लॉगिन करने की ज़रूरत नहीं है
सामग्री लॉगिन या सदस्यता के बिना उपलब्ध है.
{ "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" } } }
मल्टी-टीयर सदस्यता
अलग-अलग सदस्यता वाले मॉडल में, सेवा देने वाली किसी कंपनी के पास सदस्यता टियर, जैसे कि गोल्ड, सिल्वर, और ब्रॉन्ज़. जिन उपयोगकर्ताओं के पास ऊपरी टियर की सदस्यता है वे सभी ऐक्सेस कर सकते हैं को कम या ज़्यादा किया जा सकता है. हालांकि, निम्न टियर वाले उपयोगकर्ता सदस्यता के सबसे ऊपर के लेवल वाले कॉन्टेंट को ऐक्सेस नहीं किया जा सकता.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-entitlements-2.png?authuser=7&hl=hi)
यह उदाहरण देखें:
- जेन ने गोल्ड टियर की सदस्यता ली. आपके एनटाइटलमेंट
एंडपॉइंट ये
entitlementId
आइडेंटिफ़ायर दिखाता है:example.com:bronze
example.com:silver
example.com:gold
- जॉन ने ब्रॉन्ज़ टियर की सदस्यता ली है. आपके एनटाइटलमेंट
एंडपॉइंट यह
entitlementId
दिखाता है:example.com:bronze
- मीडिया ऐक्शन फ़ीड में इन ज़रूरी शर्तों के बारे में बताया गया है:
- मूवी A के लिए
example.com:bronze
की ज़रूरत है. - मूवी B के लिए
example.com:silver
की ज़रूरत है.
- मूवी A के लिए
इस स्थिति में, Google, जेन के लिए ये ऐक्सेस लेवल तय करता है और जॉन:
- जेन और जॉन, दोनों के पास मूवी A का ऐक्सेस है.
- जेन के पास Movie B का ऐक्सेस है, लेकिन जय के पास नहीं.
{ "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "subscription", "requiresSubscription": { "@type": "MediaSubscription", "@id": "http://www.example.com/basic_subscription", "name": "Bronze", "commonTier": true ... }, ... } }
ऐड-ऑन की सदस्यता
ऐड-ऑन सदस्यता वाले मॉडल में, सेवा देने वाली कंपनी, उपयोगकर्ताओं को ये काम करने की अनुमति देती है अपने एनटाइटलमेंट को बड़ा कर सकते हैं और बुनियादी सदस्यता में चैनलों को जोड़ सकते हैं. लोग जितने चाहें उतने चैनल जोड़े जा सकते हैं.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-entitlements-3.png?authuser=7&hl=hi)
यह उदाहरण देखें:
- जेन के पास PRO और PRO
बेसिक सदस्यता. एनटाइटलमेंट का एंडपॉइंट,
ये
entitlementId
आइडेंटिफ़ायर:example.com:basic
example.com:pro
example.com:sportz
- राहुल के पास सिर्फ़ बेसिक की सदस्यता है. आपके एनटाइटलमेंट
एंडपॉइंट यह
entitlementId
दिखाता है:example.com:basic
- मीडिया ऐक्शन फ़ीड में इन ज़रूरी शर्तों के बारे में बताया गया है:
- मूवी A के लिए
example.com:basic
की ज़रूरत है. - मूवी B के लिए
example.com:pro
की ज़रूरत है.
- मूवी A के लिए
इस स्थिति में, Google, जेन के लिए ये ऐक्सेस लेवल तय करता है और जॉन:
- जेन और जॉन, दोनों के पास मूवी A का ऐक्सेस है.
- जेन के पास Movie 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
रेंटल.
लाइव टीवी
मीडिया के लिए कार्रवाइयों वाले फ़ीड में, आप लाइव टीवी के ऐक्सेस पर पाबंदी लगा सकते हैं channel या इवेंट ये दो उपयोगकर्ता शर्तें हैं:
-
उपयोगकर्ता के डिवाइस की जगह की जानकारी
टीवी चैनल के ऐक्सेस पर पाबंदी लगाने के लिए, वह इलाका बताएं जहां उपयोगकर्ता उसे ऐक्सेस कर सकता है. आम तौर पर, यह स्थिति लोकल ब्रॉडकास्ट पर लागू होती है टीवी चैनल.
-
उपयोगकर्ता के खाते की स्थिति
अगर किसी टीवी चैनल का ऐक्सेस, उपयोगकर्ता की खाता-लेवल सेटिंग पर निर्भर करता है, तो इस्तेमाल एनटाइटलमेंट आइडेंटिफ़ायर को पाबंदी को दिखाता है.
आम तौर पर, यह शर्त इन मामलों में लागू होती है:
- बंडल: नैशनल चैनल अक्सर बंडल चुनें, और उपयोगकर्ता यह चुन सकें कि वे किस बंडल की सदस्यता लेना चाहते हैं.
- ऐड-ऑन: कुछ प्रीमियम चैनलों के लिए, उपयोगकर्ताओं के लिए ज़रूरी है कि अपनी सदस्यता में चुनिंदा रूप से अतिरिक्त चैनल जोड़ना.
- रीजनल स्पोर्ट्स नेटवर्क (आरएसएन): आरएसएन आम तौर पर उपयोगकर्ता के "घर" से जुड़ा होता है स्थान. उपयोगकर्ता कॉन्टेंट देख सकते हैं आरएसएन पर तब भी विज्ञापन दिखाकर, जब वे अपने "घर" से बाहर जाते हैं स्थान.
तीसरे पक्ष की सदस्यता
तीसरे पक्ष की सदस्यता
सदस्यों के लिए कॉन्टेंट किसी दूसरी सेवा के ज़रिए उपलब्ध हो.
{ "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 Search, Android TV, और Google Assistant शामिल हैं. उपयोगकर्ता को सेट करने के लिए तो Google को यह समझना होगा कि सामान्य टियर का इस्तेमाल करके सदस्य बने. Google को यह भी समझना चाहिए कि खास तरह के सदस्यता पैकेज वाले सदस्यों के लिए ही उपलब्ध है.
Google सामान्य स्तर पर उपलब्ध टाइटल का सुझाव तब तक देता है, जब तक कि आप एनटाइटलमेंट एपीआई को सबमिट करना ज़रूरी है. इस एपीआई की मदद से, Google उपयोगकर्ता ऐक्सेस कर सकता है.
मुझे कॉमन टीयर पैकेज कब बनाना चाहिए?
जब आपकी सेवा ऐसी सामग्री ऑफ़र करती है जिसमें सभी सदस्यों के लिए उपलब्ध है. इसमें सिर्फ़ एक पैकेज का ऑफ़र देने वाली सेवाएं शामिल हैं कई पैकेज या ऐड-ऑन ऑफ़र करने वाली सेवाएं.
सेवा देने वाली जिन कंपनियों के पास सभी सदस्यों के लिए कोई कॉन्टेंट उपलब्ध नहीं है उन्हें यह कॉन्टेंट बनाने की ज़रूरत नहीं है एक कॉमन टियर पैकेज है. उदाहरण के लिए, सेवा देने वाली ऐसी कंपनियां जो म्यूचुअली एक्सक्लूसिव हैं और अपने सभी पैकेज में कॉन्टेंट को शामिल कर सकता है.
टियर के सामान्य उदाहरण
सामान्य टियर के उदाहरण यहां दिए गए हैं.
अलग-अलग लेवल वाली सदस्यता
अलग-अलग सदस्यता वाले मॉडल में, सेवा देने वाली किसी कंपनी के पास कई सदस्यताएं होती हैं टियर, जैसे कि गोल्ड, सिल्वर, और ब्रॉन्ज़ टियर. Gemini Business, ज़्यादा कीमत वाली सदस्यता में, निचले लेवल के सारे कॉन्टेंट का ऐक्सेस होता है. लोग जिन्हें लोअर-टियर सदस्यता में, ऊपर दिए गए कॉन्टेंट के टियर. यहां दी गई इमेज, पैकेज के स्ट्रक्चर का एक उदाहरण है.
![गोल्ड टीयर में सिल्वर टीयर का पूरा कॉन्टेंट होता है, जो
इसमें सभी ब्रॉन्ज़ टियर शामिल होते हैं.](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/tieredsub.png?authuser=7&hl=hi)
नीचे दिए गए कोड उदाहरण में, ब्रॉन्ज़ पैकेज सामान्य टियर है, क्योंकि सभी उपयोगकर्ताओं के पास उस कैटगरी के सारे कॉन्टेंट का ऐक्सेस हो.
"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 } ],
ऐड-ऑन
ऐड-ऑन सदस्यता वाले मॉडल में, सेवा देने वाली कंपनी, उपयोगकर्ताओं को और चैनल को बेसिक सदस्यता में जोड़ते हैं. उपयोगकर्ता इस तौर पर जोड़ सकते हैं कई चैनल चुन सकते हैं. यहां दी गई इमेज, पैकेज का एक उदाहरण है स्ट्रक्चर.
![हर उपयोगकर्ता बेसिक चैनल से शुरुआत करता है और
PRO, Sportsz, और Moviemax चैनलों का कोई भी कॉम्बिनेशन इस्तेमाल किया जा सकता है.](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/addonssub.png?authuser=7&hl=hi)
अगर आपका चैनल सभी उपयोगकर्ताओं के लिए उपलब्ध है और चैनल की तरह, पैकेज को कॉमन टीयर पैकेज के साथ मर्ज किया जा सकता है.
नीचे दिए गए कोड उदाहरण में, बेसिक पैकेज एक सामान्य टियर है, क्योंकि सभी उपयोगकर्ता इस पैकेज के सारे कॉन्टेंट को ऐक्सेस कर सकते हैं.
"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 के बीच ओवरलैप है
'सामान्य श्रेणी' लेबल किया गया.](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/intersect.png?authuser=7&hl=hi)
कोड के इस उदाहरण में, कंपनी तीन पैकेज ऑफ़र करती है, जिनमें कुछ कॉन्टेंट सभी पैकेज में शामिल है. इस मामले में, चौथा पैकेज जो सामान्य टियर के बारे में हो. इसमें पूरा कॉन्टेंट शामिल होना चाहिए सभी तीन पैकेज में उपलब्ध होगा.
"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 पूरी तरह से अलग हैं.](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/nointersect.png?authuser=7&hl=hi)
यहां दिए गए उदाहरण में, कंपनी बिना किसी कॉन्टेंट के तीन पैकेज ऑफ़र करती है सभी पैकेज को एक-दूसरे से काटते हुए. किसी सामान्य टियर पैकेज की ज़रूरत नहीं होती है.
"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 } ],
एनटाइटलमेंट एंडपॉइंट
इस सेक्शन में दी गई जानकारी का इस्तेमाल करके, उस एचटीटीपीएस एंडपॉइंट को होस्ट करें जो किसी उपयोगकर्ता से जुड़े एनटाइटलमेंट.
पूर्वापेक्षा
शुरू करने से पहले, पुष्टि करें कि आपकी सेवा Google के साथ OAuth 2.0 फ़्लो.
अनुरोध
किसी उपयोगकर्ता के एनटाइटलमेंट पाने के लिए, Google एक अनुरोध भेजता है. इस अनुरोध में, उपयोगकर्ता का OAuth टोकन. आपके एंडपॉइंट को उस OAuth के आधार पर उपयोगकर्ता की पहचान करनी है टोकन. नीचे दिया गया उदाहरण देखें:
GET /resource HTTP/1.1
Host: server.example.com
Authorization: Bearer <OAuthToken>
जवाब
आपके एंडपॉइंट को इन प्रॉपर्टी के साथ रिस्पॉन्स देना चाहिए:
प्रॉपर्टी | |
---|---|
subscription |
ज़रूरी है यह रूट रिस्पॉन्स के अंदर का फ़ील्ड है. |
subscription.type |
ज़रूरी है इस प्रॉपर्टी में ये वैल्यू हो सकती हैं:
|
subscription.expiration_date |
ज़रूरी नहीं इस एनटाइटलमेंट की समयसीमा खत्म होने की तारीख, इसमें ISO 8601 फ़ॉर्मैट, जिसमें टाइमज़ोन शामिल है. ज़्यादा जानकारी के लिए, यह देखें खत्म होने की तारीखें. |
entitlements |
ज़रूरी नहीं इस रूट प्रॉपर्टी में वे |
entitlements.entitlement |
अगर आपके स्ट्रीमिंग कैटलॉग का ऐक्सेस अलग-अलग है, तो यह ज़रूरी है किस टाइप की सदस्यता है. इस प्रॉपर्टी में |
entitlements.expiration_date |
ज़रूरी नहीं इस सदस्यता की समय-सीमा खत्म होने की तारीख, इसमें ISO 8601 फ़ॉर्मैट, जिसमें टाइमज़ोन शामिल है. ज़्यादा जानकारी के लिए, यह देखें खत्म होने की तारीखें. |
खत्म होने की तारीखें
एंडपॉइंट रिस्पॉन्स में दो प्रॉपर्टी होती हैं, जो खत्म होने की तारीख हैंडल करती हैं
तारीख: subscription.expiration_date
और entitlements.expiration_date
. आपने लोगों तक पहुंचाया मुफ़्त में
में से एक या कोई भी नहीं शामिल कर सकता है, लेकिन दोनों नहीं. यह इस बात पर निर्भर करता है कि आप किस डिवाइस का इस्तेमाल करेंगे
सदस्यता का मॉडल उपलब्ध कराता है.
सदस्यता का मॉडल | |
---|---|
सभी सदस्यों के लिए, आपके स्ट्रीमिंग कैटलॉग का ऐक्सेस एक जैसा होना चाहिए. | क्योंकि आपको entitlements बताने की ज़रूरत नहीं है
प्रॉपर्टी के हिसाब से, subscription.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" } ] }
रेट लिमिट
Google, लोगों के एनटाइटलमेंट की जानकारी को हर छह घंटे में रीफ़्रेश करता है. यहां की यात्रा पर हूं हर सेकंड की ज़्यादा से ज़्यादा क्वेरी (क्यूपीएस) को आसान बनाने के लिए, Google इन क्वेरी को समय के साथ समान रूप से आपके एंडपॉइंट तक समान रूप से पहुंचाता है. इस तरह, अनुमानित औसत समय का अनुमान लगाया जा सकता है यहां दिए गए फ़ॉर्मूला की मदद से, आपके एंडपॉइंट के लिए क्यूपीएस:
अनुमानित औसत क्यूपीएस = <उपयोगकर्ताओं की कुल संख्या> / 21,600 सेकंड (6 घंटे x 60 मिनट x 60 सेकंड)
अगर आपका ऐप्लिकेशन कई उपयोगकर्ताओं के लिए उपलब्ध है, तो Google छह घंटे के इंटरवल में बदलाव कर सकता है. अगर ज़रूरी हो, तो कॉन्फ़िगरेशन पर चर्चा करने के लिए Google से संपर्क करें.
Google से संपर्क करें
जब आपका एंडपॉइंट तैयार हो जाए, तो इसके बारे में बताने के लिए Google से संपर्क करें.
कार्रवाई के ऐक्सेस की खास बातें
ज़्यादा जानकारी के लिए, रेफ़रंस के लिए कार्रवाई ऐक्सेस की खास बातों की प्रॉपर्टी सेक्शन जानकारी.