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" لدى المستخدم.