Google, उपयोगकर्ता के डिवाइस पर एक ऐसा प्लैटफ़ॉर्म बना रहा है जो वर्टिकल के हिसाब से ऐप्लिकेशन साथ ही, उपयोगकर्ताओं को उनके हिसाब से कॉन्टेंट देखने का बेहतर अनुभव मिलता है. खोजने के लिए इस्तेमाल किया जा सकता है. फ़ुलस्क्रीन वाले इस अनुभव से डेवलपर पार्टनर को अपना सबसे अच्छा रिच कॉन्टेंट दिखाने का मौका उसके ऐप्लिकेशन के बारे में बात करते हैं.
इस गाइड में डेवलपर पार्टनर के लिए निर्देश दिए गए हैं, ताकि वे अपना ऑडियो इंटिग्रेट कर सकें कॉन्टेंट बनाने के लिए, Engage SDK टूल का इस्तेमाल करके, इस नए सरफ़ेस एरिया और मौजूदा Google प्लैटफ़ॉर्म का इस्तेमाल नहीं किया जा सकता.
इंटिग्रेशन की जानकारी
शब्दावली
इस इंटिग्रेशन में ये तीन तरह के क्लस्टर शामिल होते हैं: सुझाव, जारी रखें और चुनिंदा.
सुझाव क्लस्टर में, कॉन्टेंट को पढ़ने के लिए आपके हिसाब से बनाए गए सुझाव दिखाए जाते हैं को भी ऐक्सेस किया जा सकता है.
आपके सुझावों के लिए यह तरीका अपनाया जाता है:
सुझाव क्लस्टर: ऐसा यूज़र इंटरफ़ेस (यूआई) व्यू जिसमें सुझाव देख सकते हैं.
पहली इमेज. Entertainment Space के यूज़र इंटरफ़ेस (यूआई) की इमेज एक पार्टनर से मिलने वाला सुझाव क्लस्टर. इकाई: क्लस्टर में किसी एक आइटम को दिखाने वाला ऑब्जेक्ट. कोई इकाई प्लेलिस्ट, ऑडियो बुक, पॉडकास्ट वग़ैरह हो सकती हैं. दिए गए निर्देश देखें उपलब्ध कराने के लिए इस्तेमाल की जा सकने वाली इकाई की सूची के लिए, इकाई का डेटा सेक्शन प्रकार.
दूसरी इमेज. Entertainment Space के यूज़र इंटरफ़ेस (यूआई) की इमेज, जिसमें सिंगल दिखाया गया है किसी एक पार्टनर के सुझाव क्लस्टर में मौजूद इकाई.
कंटिन्युएशन क्लस्टर में ऐसे ऑडियो कॉन्टेंट दिखते हैं जिनमें हाल ही में उपयोगकर्ताओं ने दिलचस्पी दिखाई है एक यूज़र इंटरफ़ेस (यूआई) ग्रुपिंग में कई डेवलपर पार्टनर के साथ काम करता है. हर डेवलपर के लिए पार्टनर को ज़्यादा से ज़्यादा 10 इकाइयों के ब्रॉडकास्ट की अनुमति होगी कंटिन्यूएशन क्लस्टर.
तीसरी इमेज. Entertainment Space के यूज़र इंटरफ़ेस (यूआई) की इमेज कई ऐप्लिकेशन से, अधूरे सुझावों वाला कॉन्टिन्यूशन क्लस्टर पार्टनर (फ़िलहाल, सिर्फ़ एक सुझाव दिख रहा है). चुनिंदा क्लस्टर में एक से ज़्यादा आइटम में से चुनिंदा आइटम दिखाए जाते हैं एक यूज़र इंटरफ़ेस (यूआई) ग्रुपिंग में डेवलपर पार्टनर. इवेंट में एक चुनिंदा फ़ीचर शामिल होगा क्लस्टर चुनें, जिसे प्राथमिकता के साथ यूज़र इंटरफ़ेस (यूआई) के सबसे ऊपरी हिस्से के पास दिखाया जाएगा प्लेसमेंट को सभी सुझावों के क्लस्टर से ऊपर रखा जाएगा. हर डेवलपर पार्टनर को चुनिंदा क्लस्टर में, ज़्यादा से ज़्यादा 10 इकाइयों के ब्रॉडकास्ट की अनुमति है.
चौथी इमेज. Entertainment Space के यूज़र इंटरफ़ेस (यूआई) की इमेज, जिसमें चुनिंदा दिखाया गया है कई पार्टनर से मिले सुझावों वाला क्लस्टर (सिर्फ़ एक पार्टनर) सुझाव फ़िलहाल दिख रहे हैं).
सेशन की तैयारी
कम से कम एपीआई लेवल: 19
अपने ऐप्लिकेशन में com.google.android.engage:engage-core
लाइब्रेरी जोड़ें:
dependencies {
// Make sure you also include that repository in your project's build.gradle file.
implementation 'com.google.android.engage:engage-core:1.5.2'
}
खास जानकारी
यह डिज़ाइन, लागू करने पर आधारित है और सेवा.
क्लाइंट के पब्लिश किए जा सकने वाले डेटा पर, नीचे दी गई सीमाएं लागू होती हैं. ये सीमाएं, क्लस्टर के टाइप:
क्लस्टर का टाइप | क्लस्टर की सीमाएं | क्लस्टर में इकाई की तय सीमाएं |
---|---|---|
सुझाव क्लस्टर | ज़्यादा से ज़्यादा पांच | ज़्यादा से ज़्यादा 50 |
कंटिन्यूएशन क्लस्टर | ज़्यादा से ज़्यादा एक | ज़्यादा से ज़्यादा 10 |
चुनिंदा क्लस्टर | ज़्यादा से ज़्यादा एक | ज़्यादा से ज़्यादा 10 |
पहला चरण: इकाई का डेटा देना
SDK टूल ने हर तरह के आइटम को दिखाने के लिए अलग-अलग इकाइयां तय की हैं. हम सहायता करते हैं सुनें की कैटगरी के लिए ये इकाइयां:
MusicAlbumEntity
MusicArtistEntity
MusicTrackEntity
MusicVideoEntity
PlaylistEntity
PodcastSeriesEntity
PodcastEpisodeEntity
LiveRadioStationEntity
AudiobookEntity
नीचे दिए गए चार्ट में हर तरह के लिए उपलब्ध एट्रिब्यूट और उनकी ज़रूरी शर्तों के बारे में बताया गया है.
MusicAlbumEntity
MusicAlbumEntity
ऑब्जेक्ट किसी संगीत एल्बम को दिखाता है (उदाहरण के लिए, Midnights
टेलर स्विफ़्ट.
एट्रिब्यूट | ज़रूरी शर्त | नोट |
---|---|---|
नाम | ज़रूरी है | संगीत एल्बम का टाइटल. |
पोस्टर की इमेज | ज़रूरी है | कम से कम एक इमेज दी जानी चाहिए. यहां जाएं: दिशा-निर्देशों के लिए, इमेज की खास बातें. |
जानकारी पेज uri | ज़रूरी है |
संगीत एल्बम के बारे में जानकारी के लिए, संगीत देने वाले ऐप्लिकेशन का डीप लिंक. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
कलाकार | ज़रूरी है | संगीत एल्बम के कलाकारों की सूची. |
वीडियो चलाने का यूआरआई | वैकल्पिक |
एक डीप लिंक, जो प्रोवाइडर ऐप्लिकेशन में एल्बम चलाना शुरू करता है. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
ब्यौरा | वैकल्पिक | अगर दिया गया हो, तो यह 200 वर्णों से ज़्यादा नहीं होना चाहिए. |
गानों की संख्या | वैकल्पिक | म्यूज़िक एल्बम में गानों की संख्या. |
शैलियां | वैकल्पिक | म्यूज़िक एल्बम में शैलियों की सूची. |
एल्बम प्रारूप | वैकल्पिक |
एल्बम (LP और डबल LP शामिल हैं) ईपी सिंगल गानों का संग्रह |
संगीत के लेबल | वैकल्पिक | एल्बम से जुड़े संगीत लेबल की सूची. |
डिवाइस पर डाउनलोड किया गया | वैकल्पिक | बूलियन से पता चलता है कि संगीत एल्बम डिवाइस में डाउनलोड किया गया है या नहीं. |
अश्लील कॉन्टेंट | वैकल्पिक |
बूलियन से पता चलता है कि कॉन्टेंट अश्लील है या नहीं ऐसे आइटम जिनमें अश्लील कॉन्टेंट हो या माता-पिता के लिए सलाह दी गई हो चेतावनी TRUE पर सेट होनी चाहिए. अश्लील आइटम "E" के साथ दिखते हैं टैग के साथ जोड़ा जा सकता है. |
रिलीज़ की तारीख | वैकल्पिक | एल्बम की रिलीज़ की तारीख epoch मिलीसेकंड में. |
कुल अवधि | वैकल्पिक | एल्बम की अवधि मिलीसेकंड में. |
उपयोगकर्ता के पिछले जुड़ाव का समय | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. इसका इस्तेमाल इन चीज़ों के लिए किया जा सकता है रैंकिंग. Epoch मिलीसेकंड में |
प्रोग्रेस का प्रतिशत पूरा हुआ | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. पूर्णांक 0 और 100 के बीच का होना चाहिए |
MusicArtistEntity
MusicArtistEntity
ऑब्जेक्ट, म्यूज़िक अरिसिस्ट के बारे में बताता है. उदाहरण के लिए, अडेल.
एट्रिब्यूट | ज़रूरी शर्त | नोट |
---|---|---|
नाम | ज़रूरी है | संगीत कलाकार का नाम. |
पोस्टर की इमेज | ज़रूरी है | कम से कम एक इमेज दी जानी चाहिए. यहां जाएं: दिशा-निर्देशों के लिए, इमेज की खास बातें. |
जानकारी पेज uri | ज़रूरी है |
संगीत के बारे में जानकारी के लिए, प्रोवाइडर ऐप्लिकेशन का डीप लिंक कलाकार. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
वीडियो चलाने का यूआरआई | वैकल्पिक |
वह डीप लिंक जो प्रोवाइडर में कलाकार के गाने चलाना शुरू करता है है. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
ब्यौरा | वैकल्पिक | अगर दिया गया हो, तो यह 200 वर्णों से ज़्यादा नहीं होना चाहिए. |
उपयोगकर्ता के पिछले जुड़ाव का समय | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. इसका इस्तेमाल इन चीज़ों के लिए किया जा सकता है रैंकिंग. Epoch मिलीसेकंड में |
MusicTrackEntity
MusicTrackEntity
ऑब्जेक्ट किसी संगीत ट्रैक को दिखाता है. उदाहरण के लिए, येलो
कोल्डप्ले)
एट्रिब्यूट | ज़रूरी शर्त | नोट |
---|---|---|
नाम | ज़रूरी है | म्यूज़िक ट्रैक का टाइटल. |
पोस्टर की इमेज | ज़रूरी है | कम से कम एक इमेज दी जानी चाहिए. यहां जाएं: दिशा-निर्देशों के लिए, इमेज की खास बातें. |
वीडियो चलाने का यूआरआई | ज़रूरी है |
एक डीप लिंक, जो प्रोवाइडर में संगीत ट्रैक को चलाना शुरू करता है है. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
जानकारी पेज uri | वैकल्पिक |
संगीत ट्रैक के बारे में जानकारी के लिए, संगीत देने वाले ऐप्लिकेशन का डीप लिंक. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
ब्यौरा | वैकल्पिक | अगर दिया गया हो, तो यह 200 वर्णों से ज़्यादा नहीं होना चाहिए. |
कुल अवधि | वैकल्पिक | ट्रैक की अवधि मिलीसेकंड में. |
एल्बम | वैकल्पिक | उस एल्बम का नाम जिससे गाना जुड़ा है. |
कलाकार | ज़रूरी है | म्यूज़िक ट्रैक के कलाकारों की सूची. |
डिवाइस पर डाउनलोड किया गया | वैकल्पिक | बूलियन से पता चलता है कि संगीत ट्रैक डिवाइस पर डाउनलोड है या नहीं. |
अश्लील कॉन्टेंट | वैकल्पिक |
बूलियन से पता चलता है कि कॉन्टेंट अश्लील है या नहीं ऐसे आइटम जिनमें अश्लील कॉन्टेंट हो या माता-पिता के लिए सलाह दी गई हो चेतावनी TRUE पर सेट होनी चाहिए. अश्लील आइटम "E" के साथ दिखते हैं टैग के साथ जोड़ा जा सकता है. |
उपयोगकर्ता के पिछले जुड़ाव का समय | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. इसका इस्तेमाल इन चीज़ों के लिए किया जा सकता है रैंकिंग. Epoch मिलीसेकंड में |
प्रोग्रेस का प्रतिशत पूरा हुआ | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. पूर्णांक 0 और 100 के बीच का होना चाहिए |
MusicVideoEntity
MusicVideoEntity
ऑब्जेक्ट, किसी संगीत वीडियो के बारे में बताता है (उदाहरण के लिए,
द वीकेंड - टेक माय ब्रेथ (आधिकारिक संगीत वीडियो)).
एट्रिब्यूट | ज़रूरी शर्त | नोट |
---|---|---|
नाम | ज़रूरी है | संगीत वीडियो का टाइटल. |
पोस्टर की इमेज | ज़रूरी है | कम से कम एक इमेज दी जानी चाहिए. यहां जाएं: दिशा-निर्देशों के लिए, इमेज की खास बातें. |
वीडियो चलाने का यूआरआई | ज़रूरी है |
एक डीप लिंक, जो प्रोवाइडर में संगीत वीडियो चलाना शुरू करता है है. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
जानकारी पेज uri | वैकल्पिक |
संगीत वीडियो के बारे में जानकारी के लिए, संगीत देने वाले ऐप्लिकेशन का डीप लिंक. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
कुल अवधि | वैकल्पिक | मिलीसेकंड में वीडियो की अवधि. |
व्यू की संख्या | वैकल्पिक | मुफ़्त टेक्स्ट फ़ॉर्मैट में वीडियो को मिले व्यू की संख्या. |
कलाकार | वैकल्पिक | संगीत वीडियो के कलाकारों की सूची. |
सामग्री रेटिंग | वैकल्पिक | ट्रैक की कॉन्टेंट रेटिंग की सूची. |
ब्यौरा | वैकल्पिक | अगर दिया गया हो, तो यह 200 वर्णों से ज़्यादा नहीं होना चाहिए. |
डिवाइस पर डाउनलोड किया गया | वैकल्पिक | बूलियन से पता चलता है कि संगीत वीडियो डिवाइस पर डाउनलोड किया गया है या नहीं. |
अश्लील कॉन्टेंट | वैकल्पिक |
बूलियन से पता चलता है कि कॉन्टेंट अश्लील है या नहीं ऐसे आइटम जिनमें अश्लील कॉन्टेंट हो या माता-पिता के लिए सलाह दी गई हो चेतावनी TRUE पर सेट होनी चाहिए. अश्लील आइटम "E" के साथ दिखते हैं टैग के साथ जोड़ा जा सकता है. |
उपयोगकर्ता के पिछले जुड़ाव का समय | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. इसका इस्तेमाल इन चीज़ों के लिए किया जा सकता है रैंकिंग. Epoch मिलीसेकंड में |
प्रोग्रेस का प्रतिशत पूरा हुआ | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. पूर्णांक 0 और 100 के बीच का होना चाहिए |
PlaylistEntity
PlaylistEntity
ऑब्जेक्ट, संगीत प्लेलिस्ट को दिखाता है. उदाहरण के लिए, अमेरिका के सबसे लोकप्रिय वीडियो
10 प्लेलिस्ट).
एट्रिब्यूट | ज़रूरी शर्त | नोट |
---|---|---|
नाम | ज़रूरी है | प्लेलिस्ट का टाइटल. |
पोस्टर की इमेज | ज़रूरी है | कम से कम एक इमेज दी जानी चाहिए. यहां जाएं: दिशा-निर्देशों के लिए, इमेज की खास बातें. |
वीडियो चलाने का यूआरआई | ज़रूरी है |
एक डीप लिंक, जो प्रोवाइडर में संगीत की प्लेलिस्ट चलाना शुरू करता है है. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
जानकारी पेज uri | वैकल्पिक |
संगीत की प्लेलिस्ट के बारे में जानकारी के लिए, प्रोवाइडर ऐप्लिकेशन का डीप लिंक. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
कुल अवधि | वैकल्पिक | प्लेलिस्ट की अवधि मिलीसेकंड में. |
गानों की संख्या | वैकल्पिक | संगीत प्लेलिस्ट में गानों की संख्या. |
ब्यौरा | वैकल्पिक | अगर दिया गया हो, तो यह 200 वर्णों से ज़्यादा नहीं होना चाहिए. |
डिवाइस पर डाउनलोड किया गया | वैकल्पिक | बूलियन से पता चलता है कि प्लेलिस्ट डिवाइस पर डाउनलोड की गई है या नहीं. |
अश्लील कॉन्टेंट | वैकल्पिक |
बूलियन से पता चलता है कि कॉन्टेंट अश्लील है या नहीं ऐसे आइटम जिनमें अश्लील कॉन्टेंट हो या माता-पिता के लिए सलाह दी गई हो चेतावनी TRUE पर सेट होनी चाहिए. अश्लील आइटम "E" के साथ दिखते हैं टैग के साथ जोड़ा जा सकता है. |
उपयोगकर्ता के पिछले जुड़ाव का समय | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. इसका इस्तेमाल इन चीज़ों के लिए किया जा सकता है रैंकिंग. Epoch मिलीसेकंड में |
प्रोग्रेस का प्रतिशत पूरा हुआ | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. पूर्णांक 0 और 100 के बीच का होना चाहिए |
PodcastSeriesEntity
PodcastSeriesEntity
ऑब्जेक्ट, पॉडकास्ट सीरीज़ के बारे में बताता है. उदाहरण के लिए, यह
American Life).
एट्रिब्यूट | ज़रूरी शर्त | नोट |
---|---|---|
नाम | ज़रूरी है | पॉडकास्ट की सीरीज़ का टाइटल. |
पोस्टर की इमेज | ज़रूरी है | कम से कम एक इमेज दी जानी चाहिए. यहां जाएं: दिशा-निर्देशों के लिए, इमेज की खास बातें. |
जानकारी वाले पेज का यूआरआई | ज़रूरी है |
पॉडकास्ट के बारे में जानकारी के लिए, प्रोवाइडर ऐप्लिकेशन का डीप लिंक सीरीज़ शामिल है. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
वीडियो चलाने का यूआरआई | वैकल्पिक |
यह एक डीप लिंक है, जिससे प्रोवाइडर ऐप्लिकेशन में पॉडकास्ट सीरीज़ चलना शुरू हो जाती है. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
एपिसोड की संख्या | वैकल्पिक | पॉडकास्ट सीरीज़ में एपिसोड की संख्या. |
प्रोडक्शन का नाम | वैकल्पिक | पॉडकास्ट सीरीज़ के प्रोडक्शन का नाम. |
होस्ट | वैकल्पिक | पॉडकास्ट सीरीज़ के होस्ट की सूची. |
शैलियां | वैकल्पिक | पॉडकास्ट सीरीज़ की शैलियों की सूची. |
डिवाइस पर डाउनलोड किया गया | वैकल्पिक | बूलियन से पता चलता है कि डिवाइस पर पॉडकास्ट डाउनलोड किया गया है या नहीं. |
ब्यौरा | वैकल्पिक | अगर दिया गया हो, तो यह 200 वर्णों से ज़्यादा नहीं होना चाहिए. |
अश्लील कॉन्टेंट | वैकल्पिक |
बूलियन से पता चलता है कि कॉन्टेंट अश्लील है या नहीं ऐसे आइटम जिनमें अश्लील कॉन्टेंट हो या माता-पिता के लिए सलाह दी गई हो चेतावनी TRUE पर सेट होनी चाहिए. अश्लील आइटम "E" के साथ दिखते हैं टैग के साथ जोड़ा जा सकता है. |
उपयोगकर्ता के पिछले जुड़ाव का समय | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. इसका इस्तेमाल इन चीज़ों के लिए किया जा सकता है रैंकिंग. Epoch मिलीसेकंड में |
PodcastEpisodeEntity
PodcastEpisodeEntity
ऑब्जेक्ट, पॉडकास्ट सीरीज़ के बारे में बताता है. उदाहरण के लिए,
स्पार्क बर्ड, एपिसोड 754: दिस अमेरिकन लाइफ़).
एट्रिब्यूट | ज़रूरी शर्त | नोट |
---|---|---|
नाम | ज़रूरी है | पॉडकास्ट के एपिसोड का टाइटल. |
पोस्टर की इमेज | ज़रूरी है | कम से कम एक इमेज दी जानी चाहिए. यहां जाएं: दिशा-निर्देशों के लिए, इमेज की खास बातें. |
वीडियो चलाने का यूआरआई | ज़रूरी है |
एक डीप लिंक, जो प्रोवाइडर में पॉडकास्ट एपिसोड चलाना शुरू करता है है. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
प्रोडक्शन सीरीज़ का टाइटल | ज़रूरी है | उस पॉडकास्ट सीरीज़ का नाम जिससे यह एपिसोड जुड़ा है. |
कुल अवधि | ज़रूरी है | मिलीसेकंड में पॉडकास्ट के एपिसोड की अवधि. |
पब्लिश होने की तारीख | ज़रूरी है | पॉडकास्ट को पब्लिश करने की तारीख (epoch मिलीसेकंड में) |
जानकारी पेज uri | वैकल्पिक |
पॉडकास्ट के एपिसोड के बारे में जानकारी के लिए, प्रोवाइडर ऐप्लिकेशन का डीप लिंक. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
प्रोडक्शन का नाम | वैकल्पिक | पॉडकास्ट सीरीज़ के प्रोडक्शन का नाम. |
एपिसोड का इंडेक्स | वैकल्पिक | सीरीज़ में एपिसोड का इंडेक्स (पहला इंडेक्स 1 है). |
होस्ट | वैकल्पिक | पॉडकास्ट एपिसोड के होस्ट की सूची. |
शैलियां | वैकल्पिक | पॉडकास्ट के एपिसोड की शैलियों की सूची. |
डिवाइस पर डाउनलोड किया गया | वैकल्पिक | बूलियन से पता चलता है कि डिवाइस पर पॉडकास्ट का एपिसोड डाउनलोड किया गया है या नहीं. |
ब्यौरा | वैकल्पिक | अगर दिया गया हो, तो यह 200 वर्णों से ज़्यादा नहीं होना चाहिए. |
वीडियो पॉडकास्ट | वैकल्पिक | बूलियन से पता चलता है कि पॉडकास्ट के एपिसोड में वीडियो कॉन्टेंट है या नहीं |
अश्लील कॉन्टेंट | वैकल्पिक |
बूलियन से पता चलता है कि कॉन्टेंट अश्लील है या नहीं ऐसे आइटम जिनमें अश्लील कॉन्टेंट हो या माता-पिता के लिए सलाह दी गई हो चेतावनी TRUE पर सेट होनी चाहिए. अश्लील आइटम "E" के साथ दिखते हैं टैग के साथ जोड़ा जा सकता है. |
अगला टाइप सुनें | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए सुझाया गया TYPE_जारी रखें - अधूरे ऑडियो आइटम को फिर से चलाएं. TYPE_Next - किसी नई सीरीज़ पर जारी रखें. TYPE_NEW - नया रिलीज़ किया गया. |
उपयोगकर्ता के पिछले जुड़ाव का समय | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. इसका इस्तेमाल इन चीज़ों के लिए किया जा सकता है रैंकिंग. Epoch मिलीसेकंड में |
प्रोग्रेस का प्रतिशत पूरा हुआ | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. पूर्णांक 0 और 100 के बीच का होना चाहिए |
LiveRadioStationEntity
LiveRadioStationEntity
ऑब्जेक्ट, लाइव रेडियो स्टेशन को दिखाता है (इसके लिए
उदाहरण के लिए, 98.1 The Breeze.
एट्रिब्यूट | ज़रूरी शर्त | नोट |
---|---|---|
नाम | ज़रूरी है | लाइव रेडियो स्टेशन का टाइटल. |
पोस्टर की इमेज | ज़रूरी है | कम से कम एक इमेज दी जानी चाहिए. यहां जाएं: दिशा-निर्देशों के लिए, इमेज की खास बातें. |
वीडियो चलाने का यूआरआई | ज़रूरी है |
एक डीप लिंक, जो सेवा देने वाली कंपनी में रेडियो स्टेशन चलाना शुरू करता है है. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
जानकारी पेज uri | वैकल्पिक |
रेडियो स्टेशन के बारे में जानकारी पाने के लिए, सेवा देने वाले ऐप्लिकेशन का डीप लिंक. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
फ़्रीक्वेंसी | वैकल्पिक | रेडियो स्टेशन के ब्रॉडकास्ट की फ़्रीक्वेंसी (उदाहरण के लिए, "98.1 एफ़एम"). |
शीर्षक दिखाएं | वैकल्पिक | रेडियो स्टेशन पर चल रहा मौजूदा शो. |
होस्ट | वैकल्पिक | रेडियो स्टेशन के होस्ट की सूची. |
ब्यौरा | वैकल्पिक | अगर दिया गया हो, तो यह 200 वर्णों से ज़्यादा नहीं होना चाहिए. |
उपयोगकर्ता के पिछले जुड़ाव का समय | वैकल्पिक |
कंटिन्यूएशन क्लस्टर में मौजूद आइटम के लिए, इसका सुझाव दिया जाता है. इसका इस्तेमाल इन चीज़ों के लिए किया जा सकता है रैंकिंग. Epoch मिलीसेकंड में |
AudiobookEntity
AudiobookEntity
ऑब्जेक्ट, किसी ऑडियो बुक को दिखाता है. उदाहरण के लिए, ऑडियो बुक
मिशैल ओबामा के Becoming में से एक लेख.
एट्रिब्यूट | ज़रूरी शर्त | नोट |
---|---|---|
नाम | ज़रूरी है | |
पोस्टर की इमेज | ज़रूरी है | कम से कम एक इमेज दी जानी चाहिए. इमेज देखें खास जानकारी देखें. |
लेखक | ज़रूरी है | कम से कम एक लेखक का नाम देना ज़रूरी है. |
Narrator | ज़रूरी है | कम से कम एक नैरेटर का नाम देना ज़रूरी है. |
कार्रवाई लिंक uri | ज़रूरी है |
ऑडियो बुक को उपलब्ध कराने वाले ऐप्लिकेशन का डीप लिंक. ध्यान दें: एट्रिब्यूशन के लिए डीप लिंक का इस्तेमाल किया जा सकता है. अक्सर पूछे जाने वाले यह सवाल देखें |
पब्लिश होने की तारीख | वैकल्पिक | अगर दिया गया हो, तो epoch मिलीसेकंड में. |
ब्यौरा | वैकल्पिक | अगर दिया गया हो, तो यह 200 वर्णों से ज़्यादा नहीं होना चाहिए. |
कीमत | वैकल्पिक | फ़्री टेक्स्ट |
कुल अवधि | वैकल्पिक | अगर डाला गया मान पॉज़िटिव होना चाहिए, तो इसे पॉज़िटिव होना चाहिए. |
शैली | वैकल्पिक | किताब से जुड़ी शैलियों की सूची. |
सीरीज़ का नाम | वैकल्पिक | उस सीरीज़ का नाम जिससे ऑडियो बुक जुड़ी है (उदाहरण के लिए, हैरी पॉटर. |
सीरीज़ यूनिट इंडेक्स | वैकल्पिक | सीरीज़ में शामिल ऑडियो बुक का इंडेक्स. यहां पहली ऑडियो बुक 1 है सीरीज़ में देखें. उदाहरण के लिए, अगर हैरी पॉटर और इसका बंदी अज़्काबान इस सीरीज़ की तीसरी किताब है. इसे तीन पर सेट किया जाना चाहिए. |
किताब का टाइप जारी रखें | वैकल्पिक |
TYPE_जारी रखें - अधूरी किताब पर फिर से शुरू करें. TYPE_Next - किसी नई सीरीज़ पर जारी रखें. TYPE_NEW - नया रिलीज़ किया गया. |
दर्शकों के जुड़ाव का आखिरी समय | शर्तों के हिसाब से ज़रूरी है | यह वैल्यू तब सबमिट की जानी चाहिए, जब आइटम कंटिन्यूएशन क्लस्टर में हो. Epoch मिलीसेकंड में. |
प्रोग्रेस का प्रतिशत पूरा हुआ | शर्तों के हिसाब से ज़रूरी है |
यह वैल्यू तब सबमिट की जानी चाहिए, जब आइटम कंटिन्यूएशन क्लस्टर में हो. *हाल ही में* हासिल की गई ऑडियो बुक, Google News ऐप्लिकेशन में क्लस्टर. इसकी वैल्यू 0 और 100 से कम होनी चाहिए. |
DisplayTimeWindow - किसी कॉन्टेंट के लिए टाइम विंडो सेट करें प्लैटफ़ॉर्म पर लोगों को दिखाने के लिए | ||
शुरू होने का टाइमस्टैंप | वैकल्पिक |
Epoch टाइमस्टैंप, जिसके बाद कॉन्टेंट की जगह है. अगर यह नीति सेट नहीं है, तो कॉन्टेंट को प्लैटफ़ॉर्म पर दिखाया जा सकता है. Epoch मिलीसेकंड में. |
खत्म होने का टाइमस्टैंप | वैकल्पिक |
उस समय का टाइमस्टैंप जिसके बाद कॉन्टेंट नहीं दिखेगा की सतह. अगर यह नीति सेट नहीं है, तो कॉन्टेंट को प्लैटफ़ॉर्म पर दिखाया जा सकता है. Epoch मिलीसेकंड में. |
इमेज की जानकारी
इमेज एसेट के लिए ज़रूरी जानकारी नीचे दी गई है:
आसपेक्ट रेशियो | ज़रूरी शर्त | कम से कम पिक्सल | सुझाए गए पिक्सल |
---|---|---|---|
स्क्वेयर (1x1) | ज़रूरी है | 300x300 | 1200x1200 |
लैंडस्केप (1.91x1) | वैकल्पिक | 600x314 | 1200x628 |
पोर्ट्रेट (4x5) | वैकल्पिक | 480x600 | 960x1200 |
फ़ाइल फ़ॉर्मैट
PNG, JPG, स्टैटिक GIF, WebP
फ़ाइल का ज़्यादा से ज़्यादा साइज़
5120 केबी
अन्य सुझाव
- इमेज के लिए सुरक्षित जगह: अपने मुख्य कॉन्टेंट को इमेज के बीच वाले 80% हिस्से में रखें इमेज.
उदाहरण
MusicAlbumEntity musicAlbumEntity =
new MusicAlbumEntity.Builder()
.setName(NAME)
.addPosterImage(new Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(960)
.setImageWidthInPixel(408)
.build())
.setPlayBackUri("https://play.google/album/play")
.setInfoPageUri("https://play.google/album/info")
.setDescription("A description of this album.")
.addArtist("Artist")
.addGenre("Genre")
.addMusicLabel("Label")
.addContentRating("Rating")
.setSongsCount(960)
.setReleaseDateEpochMillis(1633032895L)
.setDurationMillis(1633L)
.build();
AudiobookEntity audiobookEntity =
new AudiobookEntity.Builder()
.setName("Becoming")
.addPosterImage(new Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(960)
.setImageWidthInPixel(408)
.build())
.addAuthor("Michelle Obama")
.addNarrator("Michelle Obama")
.setActionLinkUri(
Uri.parse("https://play.google/audiobooks/1"))
.setDurationMillis(16335L)
.setPublishDateEpochMillis(1633032895L)
.setDescription("An intimate, powerful, and inspiring memoir")
.setPrice("$16.95")
.addGenre("biography")
.build();
दूसरा चरण: क्लस्टर डेटा उपलब्ध कराना
हमारा सुझाव है कि बैकग्राउंड में कॉन्टेंट पब्लिश करने का काम लागू करें (उदाहरण के लिए, WorkManager का इस्तेमाल करके) और नियमित आधार पर या किसी इवेंट के आधार पर शेड्यूल किया गया हो. उदाहरण के लिए, हर बार उपयोगकर्ता ऐप्लिकेशन खोलता है या जब उपयोगकर्ता ने अपने कार्ट में कुछ जोड़ा होता है).
क्लस्टर पब्लिश करने की ज़िम्मेदारी AppEngagePublishClient
की है. फ़ॉलो कर रहे हैं
क्लाइंट में एपीआई उपलब्ध हैं:
isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
deleteUserManagementCluster
deleteClusters
isServiceAvailable
इस एपीआई का इस्तेमाल यह पता लगाने के लिए किया जाता है कि सेवा, इंटिग्रेशन और कि कॉन्टेंट को डिवाइस पर दिखाया जा सकता है या नहीं.
Kotlin
client.isServiceAvailable.addOnCompleteListener { task -> if (task.isSuccessful) { // Handle IPC call success if(task.result) { // Service is available on the device, proceed with content // publish calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } }
Java
client.isServiceAvailable().addOnCompleteListener(task - > { if (task.isSuccessful()) { // Handle success if(task.getResult()) { // Service is available on the device, proceed with content publish // calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } });
publishRecommendationClusters
इस एपीआई का इस्तेमाल, RecommendationCluster
ऑब्जेक्ट की सूची को पब्लिश करने के लिए किया जाता है.
Kotlin
client.publishRecommendationClusters( PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Trending music") .build()) .build())
Java
client.publishRecommendationClusters( new PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( new RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Trending music") .build()) .build());
जब सेवा को अनुरोध मिलता है, तो नीचे दी गई कार्रवाइयां होती हैं एक लेन-देन:
- डेवलपर पार्टनर से मिला,
RecommendationCluster
का मौजूदा डेटा हटा दिया जाता है. - अनुरोध के डेटा को पार्स किया जाता है और अपडेट किए गए सुझाव में सेव किया जाता है क्लस्टर.
कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति रखरखाव किया जा रहा है.
publishFeaturedCluster
इस एपीआई का इस्तेमाल, FeaturedCluster
ऑब्जेक्ट की सूची को पब्लिश करने के लिए किया जाता है.
Kotlin
client.publishFeaturedCluster( PublishFeaturedClusterRequest.Builder() .setFeaturedCluster( FeaturedCluster.Builder() ... .build()) .build())
Java
client.publishFeaturedCluster( new PublishFeaturedClusterRequest.Builder() .setFeaturedCluster( new FeaturedCluster.Builder() ... .build()) .build());
जब सेवा को अनुरोध मिलता है, तो नीचे दी गई कार्रवाइयां होती हैं एक लेन-देन:
- डेवलपर पार्टनर से मिला,
FeaturedCluster
का मौजूदा डेटा हटा दिया जाता है. - अनुरोध के डेटा को पार्स किया जाता है और अपडेट किए गए चुनिंदा क्लस्टर में स्टोर किया जाता है.
कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति रखरखाव किया जा रहा है.
publishContinuationCluster
इस एपीआई का इस्तेमाल, ContinuationCluster
ऑब्जेक्ट को पब्लिश करने के लिए किया जाता है.
Kotlin
client.publishContinuationCluster( PublishContinuationClusterRequest.Builder() .setContinuationCluster( ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
Java
client.publishContinuationCluster( PublishContinuationClusterRequest.Builder() .setContinuationCluster( ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
जब सेवा को अनुरोध मिलता है, तो नीचे दी गई कार्रवाइयां होती हैं एक लेन-देन:
- डेवलपर पार्टनर से मिला,
ContinuationCluster
का मौजूदा डेटा हटा दिया जाता है. - अनुरोध के डेटा को पार्स किया जाता है और अपडेट किए गए कंटिन्युएशन में स्टोर किया जाता है क्लस्टर.
कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति रखरखाव किया जा रहा है.
publishUserAccountManagementRequest
इस एपीआई का इस्तेमाल साइन इन कार्ड को पब्लिश करने के लिए किया जाता है . साइन इन करने की कार्रवाई उपयोगकर्ता को यहां ले जाएगी: ऐप्लिकेशन के साइन इन पेज पर, ताकि ऐप्लिकेशन कॉन्टेंट पब्लिश कर सके (या ज़्यादा जानकारी उपलब्ध करा सके) आपके हिसाब से बनाया गया कॉन्टेंट)
नीचे दिया गया मेटाडेटा, साइन इन कार्ड का हिस्सा है -
एट्रिब्यूट | ज़रूरी शर्त | ब्यौरा |
---|---|---|
ऐक्शन Uri | ज़रूरी है | कार्रवाई के लिए डीपलिंक (यानी कि ऐप्लिकेशन के साइन-इन पेज पर ले जाता है) |
इमेज | वैकल्पिक - अगर टाइटल नहीं दिया गया है, तो टाइटल देना ज़रूरी है |
कार्ड पर दिखाई गई चित्र 16x9 के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) वाली इमेज, जिनका रिज़ॉल्यूशन 1264x712 है |
शीर्षक | वैकल्पिक - अगर दी नहीं गई है, तो इमेज दी जानी चाहिए | कार्ड पर लिखा टाइटल |
कार्रवाई टेक्स्ट | वैकल्पिक | सीटीए पर दिखाया गया टेक्स्ट (यानी साइन इन करें) |
उपशीर्षक | वैकल्पिक | कार्ड पर वैकल्पिक सबटाइटल |
Kotlin
var SIGN_IN_CARD_ENTITY = SignInCardEntity.Builder() .addPosterImage( Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build() client.publishUserAccountManagementRequest( PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
Java
SignInCardEntity SIGN_IN_CARD_ENTITY = new SignInCardEntity.Builder() .addPosterImage( new Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build(); client.publishUserAccountManagementRequest( new PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
जब सेवा को अनुरोध मिलता है, तो नीचे दी गई कार्रवाइयां होती हैं एक लेन-देन:
- डेवलपर पार्टनर से मिला मौजूदा
UserAccountManagementCluster
डेटा यह है हटाया गया. - अनुरोध के डेटा को पार्स किया जाता है और अपडेट किए गए UserAccountManagementCluster क्लस्टर.
कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति रखरखाव किया जा रहा है.
updatePublishStatus
अगर कारोबार की किसी अंदरूनी वजह से, कोई भी क्लस्टर पब्लिश नहीं किया गया है, हमारा सुझाव है कि आप updateपब्लिशStatus एपीआई. ऐसा इसलिए ज़रूरी है, क्योंकि :
- कॉन्टेंट पब्लिश होने के बाद भी, हर स्थिति में स्टेटस देना (STATUS == पब्लिश किया गया), इसका इस्तेमाल करने वाले डैशबोर्ड को भरने के लिए ज़रूरी है स्टेटस के बारे में भी बताएं.
- अगर कोई कॉन्टेंट पब्लिश नहीं हुआ है, लेकिन इंटिग्रेशन की स्थिति सही से काम नहीं करती है (STATUS == NOT_PUBLISHED), Google ऐप्लिकेशन में चेतावनियों को ट्रिगर होने से रोक सकता है हेल्थ डैशबोर्ड्स. यह पुष्टि करता है कि कॉन्टेंट को पब्लिश नहीं करने की वजह से उम्मीद के मुताबिक स्थिति हो सकती है.
- इससे डेवलपर को यह इनसाइट देने में मदद मिलती है कि डेटा कब पब्लिश किया गया है और कब नहीं.
- Google, इन स्टेटस कोड का इस्तेमाल करके, उपयोगकर्ता को ताकि वे ऐप्लिकेशन का कॉन्टेंट देख सकें या उससे उबर सकें.
पब्लिश करने की मंज़ूरी की स्थिति वाले कोड की सूची यहां दी गई है :
// Content is published
AppEngagePublishStatusCode.PUBLISHED,
// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,
// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,
// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,
// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,
// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,
// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,
// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,
// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER
अगर कॉन्टेंट को पब्लिश नहीं किया गया है, क्योंकि उपयोगकर्ता ने लॉग इन नहीं किया है, Google, साइन इन कार्ड को पब्लिश करने का सुझाव देगा. अगर किसी वजह से सेवा देने वाली कंपनियां, साइन इन कार्ड पब्लिश नहीं कर पा रही हैं इसके बाद, हमारा सुझाव है कि आप updatepublishStatus API पर कॉल करें स्थिति कोड NOT_PUBLISHED_REQUIRES_SIGN_IN के साथ
Kotlin
client.updatePublishStatus( PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build())
Java
client.updatePublishStatus( new PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build());
deleteRecommendationClusters
इस एपीआई का इस्तेमाल, सुझाव क्लस्टर का कॉन्टेंट मिटाने के लिए किया जाता है.
Kotlin
client.deleteRecommendationClusters()
Java
client.deleteRecommendationClusters();
जब सेवा को अनुरोध मिलता है, तो वह सुझाव क्लस्टर. कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति बनी रहेगी.
deleteFeaturedCluster
इस एपीआई का इस्तेमाल, चुनिंदा क्लस्टर का कॉन्टेंट मिटाने के लिए किया जाता है.
Kotlin
client.deleteFeaturedCluster()
Java
client.deleteFeaturedCluster();
जब सेवा को अनुरोध मिलता है, तो वह चुनिंदा क्लस्टर. कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति बनी रहेगी.
deleteContinuationCluster
इस एपीआई का इस्तेमाल, कंटिन्युएशन क्लस्टर का कॉन्टेंट मिटाने के लिए किया जाता है.
Kotlin
client.deleteContinuationCluster()
Java
client.deleteContinuationCluster();
जब सेवा को अनुरोध मिलता है, तो वह कंटिन्यूएशन क्लस्टर. कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति बनी रहेगी.
deleteUserManagementCluster
इस एपीआई का इस्तेमाल UserAccountManagement Cluster का कॉन्टेंट मिटाने के लिए किया जाता है.
Kotlin
client.deleteUserManagementCluster()
Java
client.deleteUserManagementCluster();
जब सेवा को अनुरोध मिलता है, तो वह UserAccountManagement क्लस्टर. किसी गड़बड़ी की स्थिति में, पूरे अनुरोध को अस्वीकार कर दिया गया है और मौजूदा स्थिति में बदलाव नहीं किया गया है.
deleteClusters
इस एपीआई का इस्तेमाल किसी खास तरह के क्लस्टर का कॉन्टेंट मिटाने के लिए किया जाता है.
Kotlin
client.deleteClusters( DeleteClustersRequest.Builder() .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) ... .build())
Java
client.deleteClusters( new DeleteClustersRequest.Builder() .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) ... .build());
जब सेवा को अनुरोध मिलता है, तो वह सभी सेवाओं से मौजूदा डेटा हटा देती है किसी खास तरह के क्लस्टर से मिलते-जुलते क्लस्टर. क्लाइंट इनमें से किसी एक तरीके को कई तरह के क्लस्टर हैं. कोई गड़बड़ी होने पर, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति को बनाए रखा जाता है.
गड़बड़ी ठीक करना
हमारा सुझाव है कि आप Publishing API की मदद से बनाए गए टास्क के नतीजे को सुनें कि किसी सफल टास्क को वापस पाने और उसे फिर से सबमिट करने के लिए, फ़ॉलो-अप कार्रवाई की जा सकती है.
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(...)
.build())
.addOnCompleteListener(
task -> {
if (task.isSuccessful()) {
// do something
} else {
Exception exception = task.getException();
if (exception instanceof AppEngageException) {
@AppEngageErrorCode
int errorCode = ((AppEngageException) exception).getErrorCode();
if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
// do something
}
}
}
});
गड़बड़ी को AppEngageException
के तौर पर दिखाया जाता है. इसके लिए, वजह भी बताई जाती है
गड़बड़ी कोड.
गड़बड़ी कोड | नोट |
---|---|
SERVICE_NOT_FOUND |
दिए गए डिवाइस पर सेवा उपलब्ध नहीं है. |
SERVICE_NOT_AVAILABLE |
दिए गए डिवाइस पर सेवा उपलब्ध है, लेकिन यह उपलब्ध नहीं है कॉल करते समय (उदाहरण के लिए, उन्हें साफ़ तौर पर बंद किया गया हो). |
SERVICE_CALL_EXECUTION_FAILURE |
थ्रेडिंग से जुड़ी समस्याओं की वजह से, टास्क नहीं चलाया जा सका. इस स्थिति में, यह दोबारा कोशिश की जाएगी. |
SERVICE_CALL_PERMISSION_DENIED |
कॉलर को सेवा कॉल करने की अनुमति नहीं है. |
SERVICE_CALL_INVALID_ARGUMENT |
अनुरोध में अमान्य डेटा मौजूद है (उदाहरण के लिए, तय सीमा से ज़्यादा क्लस्टर की संख्या). |
SERVICE_CALL_INTERNAL |
सेवा की ओर कोई गड़बड़ी है. |
SERVICE_CALL_RESOURCE_EXHAUSTED |
सेवा कॉल बार-बार किया जाता है. |
तीसरा चरण: ब्रॉडकास्ट के इंटेंट मैनेज करना
किसी जॉब के ज़रिए, Publishing Content API कॉल करने के अलावा, यह
सेट अप करने के लिए ज़रूरी है
पाने के लिए BroadcastReceiver
कॉन्टेंट पब्लिश करने का अनुरोध सबमिट करें.
ब्रॉडकास्ट इंटेंट का मकसद, मुख्य रूप से ऐप्लिकेशन को फिर से चालू करना और डेटा को ज़बरदस्ती लागू करना है सिंक. ब्रॉडकास्ट के इंटेंट, इस तरह से डिज़ाइन नहीं किए जाते कि उन्हें समय-समय पर भेजा जा सके. यह सिर्फ़ यह तब ट्रिगर होता है, जब Engage सेवा यह तय करती है कि कॉन्टेंट पुराना है या नहीं (इसके लिए उदाहरण के लिए, एक हफ़्ते पुराना). इस तरह, विज्ञापन देखने वाले को भरोसा होगा कि वह आपको एक नया कॉन्टेंट अनुभव मिलेगा, भले ही ऐप्लिकेशन को लंबे समय तक रोका है.
BroadcastReceiver
को इन दो तरीकों से सेट अप किया जाना चाहिए:
BroadcastReceiver
क्लास के इंस्टेंस को डाइनैमिक तौर पर रजिस्टर करने के लिए, इनका इस्तेमाल करेंContext.registerReceiver()
. इसकी मदद से, ऐप्लिकेशन के ज़रिए बातचीत की जा सकती है जो अब भी मेमोरी में हैं.
class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}
public static void registerBroadcastReceivers(Context context) {
context = context.getApplicationContext();
// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));
// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));
// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION));
}
- अपने
<receiver>
AndroidManifest.xml
फ़ाइल. इससे ऐप्लिकेशन को ब्रॉडकास्ट मिलने लगता है इंटेंट, जब वह नहीं चल रहा होता है, और ऐप्लिकेशन को प्रकाशित करने की अनुमति भी देता है या वीडियो कॉन्टेंट.
<application>
<receiver
android:name=".AppEngageBroadcastReceiver"
android:exported="true"
android:enabled="true">
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
</intent-filter>
</receiver>
</application>
ये इंटेंट सेवा:
com.google.android.engage.action.PUBLISH_RECOMMENDATION
हमारा सुझाव है कि आपpublishRecommendationClusters
कॉल तब शुरू करें, जब इस इंटेंट को स्वीकार कर रहे हैं.com.google.android.engage.action.PUBLISH_FEATURED
हमारा सुझाव है कि इस कॉल को पाने के लिए,publishFeaturedCluster
कॉल करें इंटेंट.com.google.android.engage.action.PUBLISH_CONTINUATION
हमारा सुझाव है कि कॉल रिसीव करने के दौरान,publishContinuationCluster
से कॉल करें इस इंटेंट के आधार पर.
एकीकरण वर्कफ़्लो
इंटिग्रेशन पूरा हो जाने के बाद, उसकी पुष्टि करने से जुड़े सिलसिलेवार निर्देश के लिए, देखें डेवलपर इंटिग्रेशन वर्कफ़्लो का इस्तेमाल करना.
अक्सर पूछे जाने वाले सवाल
इनके बारे में जानने के लिए, जुड़ाव वाले SDK टूल के बारे में अक्सर पूछे जाने वाले सवाल देखें अक्सर पूछे जाने वाले सवाल.
संपर्क
संपर्क जानकारी engagement-developers@google.com पर, अगर वहां इंटिग्रेशन के दौरान अगर आपका कोई सवाल था. हमारी टीम जल्द से जल्द जवाब देगी किया जा सकता है.
अगले चरण
इस इंटिग्रेशन को पूरा करने के बाद, आपको ये काम करने होंगे:
- इन्हें ईमेल भेजें engagement-developers@google.com और अटैच करें आपका इंटिग्रेट किया गया APK, जिसे Google टेस्ट करने के लिए तैयार है.
- Google यह पक्का करने के लिए संगठन में काम करने वाले लोगों के लिए, कारोबार की पुष्टि और समीक्षा करेगा इंटिग्रेशन उम्मीद के मुताबिक काम करता है. ज़रूरत पड़ने पर, Google आपसे संपर्क करेगा पर ईमेल करें.
- जांच पूरी हो जाने और किसी बदलाव की ज़रूरत न होने पर, Google आपसे संपर्क करेगा आपको सूचित करेगा कि आप अपडेट किए गए और एकीकृत APK प्रकाशित करना शुरू कर सकते हैं Play Store पर टैप करें.
- जब Google पुष्टि कर देगा कि आपका अपडेट किया गया APK Play Store, आपका सुझाव, चुनिंदा, और जारी रखना क्लस्टर पब्लिश कर दिए जाएंगे और उपयोगकर्ताओं को दिखेंगे.