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

 आपके ऐप्लिकेशन से बनाए गए सभी एल्बम की सूची दिखाता है.

patch

 ऐप्लिकेशन से बनाए गए एल्बम को, बताए गए id से अपडेट करें.