ऐक्सेस की ज़रूरी शर्तें

उपयोगकर्ता ऐसे कॉन्टेंट को देखना या सुनना पसंद करते हैं जिसे वे पहले से ही ऐक्सेस कर सकते हैं, जैसे कि कॉन्टेंट मैनेजर बना सकता है. अगर Google को पता हो कि उपयोगकर्ता किस तरह के कॉन्टेंट को ऐक्सेस कर सकता है का इस्तेमाल किया जा सकता है, तो Google एक बेहतर खोज नतीजा तैयार कर सकता है या रिस्पॉन्स के तौर पर, लोगों को उस कॉन्टेंट पर ले जाएं.

कॉन्टेंट ऐक्सेस करने से जुड़ी ज़रूरी शर्तों के बारे में बताएं

आपको अपने कैटलॉग. ऐसा करते समय, इन बातों का ध्यान रखें:

• क्या कॉन्टेंट को ऐक्सेस करने के लिए, लोगों को आपके ऐप्लिकेशन या प्लैटफ़ॉर्म में लॉग इन करना ज़रूरी है?

• क्या उपयोगकर्ताओं को सदस्यता की ज़रूरत होती है?

  सिर्फ़ देखने की कार्रवाइयां:

  • क्या उपयोगकर्ताओं को, सेवा देने वाली किसी बाहरी कंपनी से सदस्यता लेनी होती है?
  • क्या आपका कारोबार अलग-अलग टीयर वाली, कई तरह के पैकेज या ऐड-ऑन वाली सदस्यता ऑफ़र करता है?

• स्मार्टवॉच की कार्रवाइयों के लिए: क्या उपयोगकर्ता को कॉन्टेंट किराये पर लेना या खरीदना होगा?

• क्या समय के साथ ऐक्सेस की ज़रूरी शर्तों में बदलाव होता है?

• क्या ऐक्सेस की ज़रूरी शर्त, डिवाइस की जगह के हिसाब से तय होती है?

ऐक्सेस से जुड़ी पाबंदियां

ऐक्सेस से जुड़ी दो तरह की पाबंदियां होती हैं:

• पेवॉल का टाइप
• भौगोलिक इलाका

पेवॉल का टाइप

पेवॉल के हिसाब से कॉन्टेंट के ऐक्सेस पर पाबंदी लगाई जा सकती है. नीचे दी गई टेबल इसमें अलग-अलग तरह के पेवॉल की जानकारी दी गई है:

वॉच ऐक्शन के लिए पेवॉल का टाइप

वॉच ऐक्शन के लिए कॉन्टेंट पेवॉल चुनने के लिए, 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.

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

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

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

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

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

"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 यह तरीका अपनाता है:

1. हम आपके उपयोगकर्ता की जानकारी पाने के लिए, एनटाइटलमेंट एंडपॉइंट एनटाइटलमेंट आइडेंटिफ़ायर.
2. हम आपके मीडिया से, कॉन्टेंट के लिए ज़रूरी एनटाइटलमेंट आइडेंटिफ़ायर का पता लगाते हैं ऐक्शन फ़ीड.
3. हम उपयोगकर्ता के entitlementId का मिलान identifier प्रॉपर्टी आपके फ़ीड में मीडिया सदस्यता ऑब्जेक्ट. अगर कम से कम एक entitlementId मिलान करता है, तो हम निर्धारित करते हैं कि उपयोगकर्ता कॉन्टेंट.

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

मल्टी-टीयर सदस्यता

अलग-अलग सदस्यता वाले मॉडल में, सेवा देने वाली किसी कंपनी के पास सदस्यता टियर, जैसे कि गोल्ड, सिल्वर, और ब्रॉन्ज़. जिन उपयोगकर्ताओं के पास ऊपरी टियर की सदस्यता है वे सभी ऐक्सेस कर सकते हैं को कम या ज़्यादा किया जा सकता है. हालांकि, निम्न टियर वाले उपयोगकर्ता सदस्यता के सबसे ऊपर के लेवल वाले कॉन्टेंट को ऐक्सेस नहीं किया जा सकता.

यह उदाहरण देखें:

• जेन ने गोल्ड टियर की सदस्यता ली. आपके एनटाइटलमेंट एंडपॉइंट ये entitlementId आइडेंटिफ़ायर दिखाता है:
  • example.com:bronze
  • example.com:silver
  • example.com:gold
• जॉन ने ब्रॉन्ज़ टियर की सदस्यता ली है. आपके एनटाइटलमेंट एंडपॉइंट यह entitlementId दिखाता है:
  • example.com:bronze
• मीडिया ऐक्शन फ़ीड में इन ज़रूरी शर्तों के बारे में बताया गया है:
  • मूवी A के लिए example.com:bronze की ज़रूरत है.
  • मूवी B के लिए example.com:silver की ज़रूरत है.

इस स्थिति में, Google, जेन के लिए ये ऐक्सेस लेवल तय करता है और जॉन:

• जेन और जॉन, दोनों के पास मूवी A का ऐक्सेस है.
• जेन के पास Movie B का ऐक्सेस है, लेकिन जय के पास नहीं.

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

ऐड-ऑन की सदस्यता

ऐड-ऑन सदस्यता वाले मॉडल में, सेवा देने वाली कंपनी, उपयोगकर्ताओं को ये काम करने की अनुमति देती है अपने एनटाइटलमेंट को बड़ा कर सकते हैं और बुनियादी सदस्यता में चैनलों को जोड़ सकते हैं. लोग जितने चाहें उतने चैनल जोड़े जा सकते हैं.

यह उदाहरण देखें:

• जेन के पास PRO और PRO बेसिक सदस्यता. एनटाइटलमेंट का एंडपॉइंट, ये entitlementId आइडेंटिफ़ायर:
  • example.com:basic
  • example.com:pro
  • example.com:sportz
• राहुल के पास सिर्फ़ बेसिक की सदस्यता है. आपके एनटाइटलमेंट एंडपॉइंट यह entitlementId दिखाता है:
  • example.com:basic
• मीडिया ऐक्शन फ़ीड में इन ज़रूरी शर्तों के बारे में बताया गया है:
  • मूवी A के लिए example.com:basic की ज़रूरत है.
  • मूवी B के लिए example.com:pro की ज़रूरत है.

इस स्थिति में, 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, ज़्यादा कीमत वाली सदस्यता में, निचले लेवल के सारे कॉन्टेंट का ऐक्सेस होता है. लोग जिन्हें लोअर-टियर सदस्यता में, ऊपर दिए गए कॉन्टेंट के टियर. यहां दी गई इमेज, पैकेज के स्ट्रक्चर का एक उदाहरण है.

नीचे दिए गए कोड उदाहरण में, ब्रॉन्ज़ पैकेज सामान्य टियर है, क्योंकि सभी उपयोगकर्ताओं के पास उस कैटगरी के सारे कॉन्टेंट का ऐक्सेस हो.

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

ऐड-ऑन

ऐड-ऑन सदस्यता वाले मॉडल में, सेवा देने वाली कंपनी, उपयोगकर्ताओं को और चैनल को बेसिक सदस्यता में जोड़ते हैं. उपयोगकर्ता इस तौर पर जोड़ सकते हैं कई चैनल चुन सकते हैं. यहां दी गई इमेज, पैकेज का एक उदाहरण है स्ट्रक्चर.

अगर आपका चैनल सभी उपयोगकर्ताओं के लिए उपलब्ध है और चैनल की तरह, पैकेज को कॉमन टीयर पैकेज के साथ मर्ज किया जा सकता है.

नीचे दिए गए कोड उदाहरण में, बेसिक पैकेज एक सामान्य टियर है, क्योंकि सभी उपयोगकर्ता इस पैकेज के सारे कॉन्टेंट को ऐक्सेस कर सकते हैं.

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

एक-दूसरे को काटने वाले कॉन्टेंट वाले पैकेज

ऐसे कॉन्टेंट मॉडल में जहां पैकेज में ऐसा कॉन्टेंट होता है जो इंटरसेक्ट करता है, एक सेवा कंपनी ऐसे पैकेज बेचता है जिनमें दूसरे पैकेज का कुछ कॉन्टेंट शामिल होता है. कॉन्टेंट बनाने पैकेज स्ट्रक्चर का एक उदाहरण दिया गया है.

कोड के इस उदाहरण में, कंपनी तीन पैकेज ऑफ़र करती है, जिनमें कुछ कॉन्टेंट सभी पैकेज में शामिल है. इस मामले में, चौथा पैकेज जो सामान्य टियर के बारे में हो. इसमें पूरा कॉन्टेंट शामिल होना चाहिए सभी तीन पैकेज में उपलब्ध होगा.

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

बिना कॉन्टेंट वाले ऐसे पैकेज जो एक-दूसरे को काटते हैं

ऐसे कॉन्टेंट मॉडल में जहां सभी कॉन्टेंट पैकेज एक-दूसरे का हिस्सा नहीं होते, एक सेवा कंपनी ऐसे पैकेज बेचती है जिनमें अन्य पैकेज का कोई कॉन्टेंट शामिल नहीं होता. कॉन्टेंट बनाने पैकेज स्ट्रक्चर का एक उदाहरण दिया गया है.

यहां दिए गए उदाहरण में, कंपनी बिना किसी कॉन्टेंट के तीन पैकेज ऑफ़र करती है सभी पैकेज को एक-दूसरे से काटते हुए. किसी सामान्य टियर पैकेज की ज़रूरत नहीं होती है.

"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.expiration_date और entitlements.expiration_date. आपने लोगों तक पहुंचाया मुफ़्त में में से एक या कोई भी नहीं शामिल कर सकता है, लेकिन दोनों नहीं. यह इस बात पर निर्भर करता है कि आप किस डिवाइस का इस्तेमाल करेंगे सदस्यता का मॉडल उपलब्ध कराता है.

रिस्पॉन्स के उदाहरण

सदस्यता की अलग-अलग स्थितियों के रिस्पॉन्स के उदाहरण यहां दिए गए हैं:

• सक्रिय सदस्यता
• चालू सदस्यता, जिसकी समयसीमा खत्म होने की तारीख है
• सदस्यता लेने की ज़रूरत नहीं है
• एक से ज़्यादा टीयर या ऐड-ऑन की चालू सदस्यताएं

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

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

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

{
  "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 से संपर्क करें.

कार्रवाई के ऐक्सेस की खास बातें

ज़्यादा जानकारी के लिए, रेफ़रंस के लिए कार्रवाई ऐक्सेस की खास बातों की प्रॉपर्टी सेक्शन जानकारी.