بالإضافة إلى accessing إلى عناصر الوسائط بعد تحميلها، يمكنك أيضًا تغيير أوصافها.
نطاق التفويض المطلوب
لتغيير أوصاف عناصر الوسائط بعد إنشائها، يمكنك استخدام
النطاق photoslibrary.edit.appcreateddata
.
تغيير أوصاف عناصر الوسائط
لتغيير وصف عنصر وسائط، أنشِئ media items update call
بمعرّف عنصر الوسائط وأدرِج الوصف الجديد في الطلب.
لتغيير وصف عنصر وسائط، يجب أن يكون تطبيقك قد حمَّل عنصر الوسائط، وأن يكون المستخدم الذي تمت مصادقته حاليًا هو المالك. يجب ألا يزيد طول الأوصاف عن 1,000 حرف
راحة
في ما يلي عنوان طلب PATCH لتعديل وصف عنصر الوسائط:
PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description
يحدّد هذا الطلب السمات التي يتم تعديلها من خلال تضمين
قناع حقل يُشار إليه من خلال المَعلمة updateMask
في عنوان URL.
تضمين الوصف الجديد في نص الطلب:
{ "description": "new-media-item-description" }
إذا نجح الرد، سيعرض الرد عنصر الوسائط المعدَّل:
{ "id": "media-item-id", "description": "new-media-item-description", "productUrl": "media-item-product-url", "baseUrl": "media-items-in-album", "mimeType": "mime-type-of-media", "mediaMetadata": { ... }, "contributorInfo": { ... }, "fileName": "item-filename" }
Java
try { // Update the description of the media item. // The new description must not be null. MediaItem updatedItem = photosLibraryClient.updateMediaItemDescription(mediaItem, "new-media-item-description"); } catch (ApiException e) { // Handle error }
PHP
try { // ID of the media item to update. $mediaItemId = "MEDIA_ITEM_ID"; // New description of the media item. $newDescription = "new-media-item-description"; // Update the description of the media item identified. $mediaItem = $photosLibraryClient->updateMediaItemDescription($mediaItemId, $newDescription); } catch (\Google\ApiCore\ApiException $e) { // Handle error }