REST Resource: albums

संसाधन: एल्बम

Google Photos में किसी एल्बम का उदाहरण. एल्बम, मीडिया आइटम के लिए कंटेनर होते हैं. अगर ऐप्लिकेशन के ज़रिए किसी एल्बम को शेयर किया गया है, तो इसमें एक और shareInfo प्रॉपर्टी होती है.

जेएसओएन के काेड में दिखाना 
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
फ़ील्ड
id

string

एल्बम का आइडेंटिफ़ायर. यह स्थायी आइडेंटिफ़ायर होता है. इसका इस्तेमाल अलग-अलग सेशन के दौरान इस एल्बम की पहचान करने के लिए किया जा सकता है.
title

string

उपयोगकर्ता को उनके Google Photos खाते में दिखाया जाने वाले एल्बम का नाम. इस स्ट्रिंग में 500 से ज़्यादा वर्ण नहीं होने चाहिए.
productUrl

string

[सिर्फ़ आउटपुट के लिए] एल्बम के लिए Google Photos का यूआरएल. इस लिंक को ऐक्सेस करने के लिए, उपयोगकर्ता को अपने Google Photos खाते में साइन इन करना होगा.
isWriteable

boolean

[सिर्फ़ आउटपुट के लिए] सही, अगर इस एल्बम में मीडिया आइटम बनाए जा सकते हैं. यह फ़ील्ड एल्बम के दिए गए दायरों और अनुमतियों पर आधारित है. अगर दायरे बदल दिए जाते हैं या एल्बम की अनुमतियां बदल दी जाती हैं, तो यह फ़ील्ड अपडेट हो जाता है.
shareInfo

object (ShareInfo)

[सिर्फ़ आउटपुट के लिए] शेयर किए गए एल्बम से जुड़ी जानकारी. अगर एल्बम कोई शेयर किया गया एल्बम है, तो यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब एल्बम बनाया जाता है और उपयोगकर्ता ने photoslibrary.sharing को अनुमति दी हो.
mediaItemsCount

string (int64 format)

[सिर्फ़ आउटपुट के लिए] एल्बम में मौजूद मीडिया आइटम की संख्या.
coverPhotoBaseUrl

string

[सिर्फ़ आउटपुट के लिए] कवर फ़ोटो की बाइट का यूआरएल. इसे ऐसे ही इस्तेमाल नहीं किया जाना चाहिए. इस्तेमाल करने से पहले, इस यूआरएल में पैरामीटर जोड़े जाने चाहिए. इस्तेमाल किए जा सकने वाले पैरामीटर की पूरी सूची के लिए, डेवलपर दस्तावेज़ देखें. उदाहरण के लिए, '=w2048-h1024' कवर फ़ोटो के डाइमेंशन को 2048 पिक्सल चौड़ाई और ऊंचाई 1024 पिक्सल पर सेट करता है.
coverPhotoMediaItemId

string

कवर फ़ोटो से जुड़े मीडिया आइटम का आइडेंटिफ़ायर.

ShareInfo

शेयर किए जाने वाले एल्बम के बारे में जानकारी. यह जानकारी सिर्फ़ तब शामिल होती है, जब एल्बम बनाया गया हो, उसे शेयर किया गया हो, और आपके पास उसे शेयर करने का विकल्प हो.

जेएसओएन के काेड में दिखाना 
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
फ़ील्ड
sharedAlbumOptions

object (SharedAlbumOptions)

ऐसे विकल्प जो यह कंट्रोल करते हैं कि शेयर किए गए एल्बम में कोई मीडिया आइटम जोड़ सकता है या उस पर टिप्पणी कर सकता है.
shareableUrl

string

शेयर किए गए Google Photos एल्बम का लिंक. वे सभी लोग एल्बम की सामग्री देख सकते हैं जिनके पास यह लिंक है, इसलिए इसका इस्तेमाल सावधानी से करें.

एल्बम में लिंक शेयर करने की सुविधा चालू होने पर ही, shareableUrl पैरामीटर दिखता है. अगर कोई उपयोगकर्ता पहले से ही किसी ऐसे एल्बम में शामिल है जो लिंक-शेयर नहीं किया गया है, तो वह इसे ऐक्सेस करने के लिए एल्बम के productUrl का इस्तेमाल कर सकता है.

अगर मालिक Google Photos ऐप्लिकेशन में लिंक शेयर करने की सुविधा बंद कर देता है या एल्बम शेयर करना बंद कर देता है, तो shareableUrl अमान्य हो जाता है.
shareToken

string

एक टोकन, जिसका इस्तेमाल किसी ऐसे उपयोगकर्ता की ओर से शेयर किए गए एल्बम में शामिल होने, उसे छोड़ने या उसकी जानकारी को फिर से पाने के लिए किया जाता है, जो मालिक नहीं है.

अगर मालिक Google Photos ऐप्लिकेशन में लिंक शेयर करने की सुविधा बंद कर देता है या एल्बम शेयर करना बंद कर देता है, तो shareToken अमान्य हो जाता है.
isJoined

boolean

अगर उपयोगकर्ता एल्बम से जुड़ा है, तो सही है. यह एल्बम के मालिक के लिए हमेशा सही होता है.
isOwned

boolean

अगर उपयोगकर्ता के पास एल्बम का मालिकाना हक है, तो यह 'सही' होगी.
isJoinable

boolean

अगर उपयोगकर्ता एल्बम को ऐक्सेस कर सकते हैं, तो वैल्यू 'सही' होगी.

SharedAlbumOptions

एल्बम शेयर करने की सुविधा को कंट्रोल करने वाले विकल्प.

जेएसओएन के काेड में दिखाना 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
फ़ील्ड
isCollaborative

boolean

अगर शेयर किया गया एल्बम सहयोगियों (वे उपयोगकर्ता जो एल्बम में शामिल हैं) को उसमें मीडिया आइटम जोड़ने की अनुमति देता है, तो यह सही है. डिफ़ॉल्ट तौर पर, यह 'गलत' पर सेट होता है.
isCommentable

boolean

अगर शेयर किया गया एल्बम सहयोगियों (वे उपयोगकर्ता जो एल्बम में शामिल हैं) को एल्बम में टिप्पणियां जोड़ने की अनुमति देता है, तो सही है. डिफ़ॉल्ट तौर पर, यह 'गलत' पर सेट होता है.

तरीके

addEnrichment

 किसी तय एल्बम में खास जगह पर एन्हैंसमेंट जोड़ता है.

batchAddMediaItems

 उपयोगकर्ता की Google Photos लाइब्रेरी में मौजूद एक या उससे ज़्यादा मीडिया आइटम को किसी एल्बम में जोड़ता है.

batchRemoveMediaItems

 किसी खास एल्बम से एक या उससे ज़्यादा मीडिया आइटम हटाता है.

create

 उपयोगकर्ता की Google Photos लाइब्रेरी में एल्बम बनाता है.

get

 बताए गए albumId के आधार पर एल्बम देता है.

list

 यह Google Photos ऐप्लिकेशन के एल्बम टैब में मौजूद, उपयोगकर्ता को दिखाए गए सभी एल्बम की सूची बनाता है.

patch

 एल्बम को id के साथ अपडेट करें.

share

 इससे किसी एल्बम को 'शेयर किया गया' के तौर पर मार्क किया जाता है और उसे अन्य लोग ऐक्सेस कर सकते हैं.

unshare

 पहले शेयर किए गए एल्बम को निजी के तौर पर मार्क करता है.