REST Resource: albums

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

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

JSON के काेड में दिखाना
{
  "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

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

JSON के काेड में दिखाना
{
  "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

ऐसे विकल्प जो किसी एल्बम को शेयर करने के कंट्रोल को कंट्रोल करते हैं.

JSON के काेड में दिखाना
{
  "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

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