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

batchRemoveMediaItems

create

get

list

patch

तय किए गए id के साथ एल्बम अपडेट करें.

share

unshare