Library API का इस्तेमाल शुरू करना

Library API की मदद से, उपयोगकर्ताओं की Google Photos लाइब्रेरी में मौजूद फ़ोटो, वीडियो, और एल्बम के साथ इंटरैक्ट किया जा सकता है. हालांकि, इस बात का ध्यान रखें कि सिर्फ़ उस कॉन्टेंट को ऐक्सेस और मैनेज किया जा सकता है जिसे आपके ऐप्लिकेशन ने बनाया है.

शुरू करने से पहले

Library API के इस्तेमाल के मुख्य उदाहरण

Library API उन स्थितियों के लिए सबसे सही है जहां आपके ऐप्लिकेशन को:

  • मीडिया अपलोड और सेव करना: आपके ऐप्लिकेशन से जनरेट हुई फ़ोटो और वीडियो को, उपयोगकर्ताओं की Google Photos लाइब्रेरी में सुरक्षित तरीके से इंपोर्ट किया जा सकता है.
  • कॉन्टेंट व्यवस्थित करना: एल्बम बनाएं और उन्हें मैनेज करें, ताकि उपयोगकर्ता ऐप्लिकेशन से जुड़े मीडिया को व्यवस्थित कर सकें.
  • फ़ोटो और एल्बम को बेहतर बनाना: टाइटल, ब्यौरा या जगह की जानकारी जैसी जानकारी जोड़कर, मीडिया आइटम और एल्बम में संदर्भ जोड़ें.
  • ऐप्लिकेशन से बनाए गए डेटा को ऐक्सेस करना: उन फ़ोटो, वीडियो, और एल्बम को ऐक्सेस करना और उनसे इंटरैक्ट करना जिन्हें आपके ऐप्लिकेशन ने पहले बनाया था.

Library API का सामान्य वर्कफ़्लो

लाइब्रेरी एपीआई कई तरह की सुविधाएं देता है. हालांकि, आम तौर पर इन चरणों को पूरा करके वर्कफ़्लो पूरा किया जा सकता है:

  1. मीडिया अपलोड करना: Google Photos पर फ़ोटो या वीडियो के बाइट को सुरक्षित तरीके से अपलोड करने के लिए, अपलोड एंडपॉइंट का इस्तेमाल करें. इस चरण में, एक uploadToken जनरेट होता है.

  2. मीडिया आइटम बनाना: उपयोगकर्ता की लाइब्रेरी में मीडिया आइटम बनाने के लिए, uploadToken देकर mediaItems.batchCreate तरीके का इस्तेमाल करें.

  3. एल्बम बनाएं (ज़रूरी नहीं): मीडिया आइटम व्यवस्थित करने के लिए, उपयोगकर्ता की लाइब्रेरी में एल्बम बनाने के लिए, albums.create तरीके का इस्तेमाल करें.

  4. एल्बम मैनेज करना:

    • albums.batchAddMediaItems का इस्तेमाल करके एल्बम में मीडिया आइटम (आपके ऐप्लिकेशन ने बनाया है) जोड़ें.
    • albums.batchRemoveMediaItems का इस्तेमाल करके, एल्बम से मीडिया आइटम हटाएं.
    • albums.addEnrichment का इस्तेमाल करके, एल्बम में टाइटल या जगहों जैसी जानकारी जोड़ें.
    • albums.get का इस्तेमाल करके, चुनिंदा एल्बम के बारे में जानकारी पाएं.
    • albums.list का इस्तेमाल करके अपने ऐप्लिकेशन से बनाए गए एल्बम की सूची बनाएं.

  5. ऐप्लिकेशन से बनाए गए मीडिया को ऐक्सेस करना:

    • mediaItems.get या mediaItems.batchGet का इस्तेमाल करके, मीडिया के किसी खास आइटम के बारे में जानकारी पाएं.
    • mediaItems.search का इस्तेमाल करके, अपने ऐप्लिकेशन से बनाए गए मीडिया आइटम खोजें.
    • ऐप्लिकेशन से बनाए गए किसी एल्बम में मौजूद मीडिया आइटम की सूची बनाने के लिए, एल्बम आईडी के साथ mediaItems.search का इस्तेमाल करें.

अगले चरण

  • रेफ़रंस दस्तावेज़ देखें: उपलब्ध सभी तरीकों और पैरामीटर के बारे में जानने के लिए, Library API के रेफ़रंस दस्तावेज़ को पढ़ें.
  • सैंपल आज़माएं: लाइब्रेरी एपीआई को काम करते हुए देखने और अपने इंटिग्रेशन के लिए प्रेरणा पाने के लिए, हमारा सैंपल देखें.