REST Resource: sharedAlbums

المرجع: ألبوم

تمثيل بألبوم في "صور Google" الألبومات هي حاويات لعناصر الوسائط. إذا شارك التطبيق ألبومًا، سيحتوي على خاصية shareInfo إضافية.

تمثيل JSON 
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
الحقول
id

string

معرِّف الألبوم هذا مُعرّف ثابت يمكن استخدامه بين الجلسات لتحديد هذا الألبوم.
title

string

اسم الألبوم المعروض للمستخدم في حسابه على "صور Google" يجب ألا تزيد هذه السلسلة عن 500 حرف.
productUrl

string

[الإخراج فقط] عنوان URL للألبوم في "صور Google" على المستخدم تسجيل الدخول إلى حسابه على "صور Google" للوصول إلى هذا الرابط.
isWriteable

boolean

[الإخراج فقط] True إذا كان بإمكانك إنشاء عناصر وسائط في هذا الألبوم. يستند هذا الحقل إلى النطاقات التي تم منحها وأذونات الألبوم. في حال تغيير النطاقات أو تغيير أذونات الألبوم، يتم تحديث هذا الحقل.
shareInfo

object (ShareInfo)

[للإخراج فقط] معلومات ذات صلة بالألبومات المشترَكة لا تتم تعبئة هذا الحقل إلا إذا كان الألبوم ألبومًا مشترَكًا، وأنشأ المطوِّر الألبوم ومنح المستخدم النطاق photoslibrary.sharing.
mediaItemsCount

string (int64 format)

[الإخراج فقط] عدد عناصر الوسائط في الألبوم
coverPhotoBaseUrl

string

[الإخراج فقط] عنوان URL بوحدات البايت الخاصة بصورة الغلاف يجب عدم استخدام هذه المَعلمة كما هي، إذ يجب إلحاق المَعلمات بعنوان URL هذا قبل استخدامها. اطّلِع على مستندات المطوّرين للحصول على قائمة كاملة بالمعلَمات المتوافقة. على سبيل المثال، يضبط '=w2048-h1024' أبعاد صورة الغلاف على عرض 2048 بكسل وارتفاعه 1024 بكسل.
coverPhotoMediaItemId

string

معرّف لعنصر الوسائط المرتبط بصورة الغلاف.

الطُرق

get

 لعرض الألبوم استنادًا إلى shareToken المحددة.

join

 الانضمام إلى ألبوم مشترَك نيابةً عن مستخدم "صور Google".

leave

 مغادرة ألبوم مشترك سبق الانضمام إليه بالنيابة عن مستخدم "صور Google".

list

 يسرد جميع الألبومات المشتركة المتاحة في علامة التبويب "المشاركة" في تطبيق "صور Google" للمستخدم.