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

अगर उपयोगकर्ता एल्बम में शामिल है, तो True. यह एल्बम के मालिक के लिए हमेशा सही होता है.
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

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