REST Resource: albums

المورد: الألبوم

تمثيل لألبوم في "صور 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

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

object (ShareInfo)

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

string (int64 format)

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

string

[للإخراج فقط] عنوان URL لوحدات البايت الخاصة بالصورة الرئيسية يجب عدم استخدام هذا العنوان كما هو. يجب إلحاق المَعلمات بهذا عنوان URL قبل استخدامه. اطّلِع على مستندات المطوّرين للحصول على قائمة كاملة بالمَعلمات المتاحة. على سبيل المثال، تضبط '=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" المشترَك يمكن لأي مستخدم لديه الرابط الاطّلاع على محتوى الألبوم، لذا يجب التعامل معه بحذر.

لا يتم عرض المَعلمة shareableUrl إلا إذا كانت ميزة "المشاركة باستخدام رابط" مفعّلة في الألبوم. إذا كان المستخدم قد انضم إلى ألبوم لم تتم مشاركته باستخدام رابط، يمكنه استخدام رمز productUrl الخاص بالألبوم للوصول إليه بدلاً من ذلك.

يتم إلغاء صلاحية shareableUrl إذا أوقف المالك ميزة "مشاركة الرابط" في تطبيق "صور Google"، أو إذا تم إلغاء مشاركة الألبوم.
shareToken

string

رمز مميّز يُستخدَم للانضمام إلى ألبوم مشترَك أو مغادرته أو استرداد تفاصيله بالنيابة عن مستخدم ليس مالكًا له.

يتم إلغاء صلاحية shareToken إذا أوقف المالك ميزة "مشاركة الرابط" في تطبيق "صور Google"، أو إذا تم إلغاء مشاركة الألبوم.
isJoined

boolean

صحيح إذا كان المستخدم قد انضم إلى الألبوم. وينطبق ذلك دائمًا على مالك الألبوم.
isOwned

boolean

صحيح إذا كان المستخدم يملك الألبوم.
isJoinable

boolean

صحيح إذا كان بإمكان المستخدمين الانضمام إلى الألبوم.

SharedAlbumOptions

الخيارات التي تتحكّم في مشاركة ألبوم

تمثيل JSON 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
الحقول
isCollaborative

boolean

صحيح إذا كان الألبوم المشترَك يسمح للمتعاونين (المستخدمين الذين انضموا إلى الألبوم) بإضافة عناصر وسائط إليه. القيمة التلقائية هي false.
isCommentable

boolean

صحيح إذا كان الألبوم المشترَك يسمح للمتعاونين (المستخدمون الذين انضموا إلى الألبوم) بإضافة تعليقات إلى الألبوم. القيمة التلقائية هي false.

الطُرق

addEnrichment

 تُضيف ميزة "تحسين المحتوى" معلومات في موضع محدّد في ألبوم تم إنشاؤه من خلال تطبيق.

batchAddMediaItems

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

batchRemoveMediaItems

 تزيل هذه العملية ملف وسائط واحدًا أو أكثر أنشأه التطبيق من ألبوم محدّد أنشأه التطبيق.

create

 يتيح هذا الإذن إنشاء ألبوم في مكتبة "صور Google" الخاصة بالمستخدم.

get

 لعرض الألبوم الذي أنشأه التطبيق استنادًا إلى albumId المحدّد.

list

 تعرض هذه السمة قائمة بجميع الألبومات التي أنشأها تطبيقك.

patch

 عدِّل الألبوم الذي أنشأه التطبيق باستخدام id المحدّد.