دسترسی به موارد رسانه ای ایجاد شده توسط برنامه

پس از برقراری تماس برای فهرست کردن محتویات یک کتابخانه یا آلبوم عکس ، به جای ذخیره آیتم های رسانه برگشتی، برنامه شما باید شناسه موارد رسانه را ذخیره کند. این به این دلیل است که محتوای آیتم های رسانه ممکن است تغییر کند و پس از مدتی مشخص، URL های موجود در پاسخ منقضی شوند. شناسه مورد رسانه به طور منحصربه‌فرد یک مورد رسانه مانند یک عکس یا یک ویدیو در کتابخانه کاربر را شناسایی می‌کند.

محدوده مجوز مورد نیاز

دسترسی به موارد رسانه ایجاد شده توسط برنامه به محدوده photoslibrary.readonly.appcreateddata نیاز دارد. برای اطلاعات بیشتر در مورد دامنه ها، به محدوده مجوز مراجعه کنید.

آیتم های رسانه ای

mediaItem نمایشی از رسانه هایی مانند عکس یا ویدیویی است که در کتابخانه Google Photos آپلود شده است. این یک شی سطح بالا است و ویژگی های آن می تواند بر اساس نوع رسانه زیرین متفاوت باشد.

جدول زیر ویژگی های mediaItem را فهرست می کند:

یک آیتم رسانه ای دریافت کنید

برای بازیابی یک مورد رسانه، با mediaItems.get با استفاده از mediaItemId تماس بگیرید. درخواست یک مورد رسانه ای را برمی گرداند.

mediaItem دارای ویژگی هایی مانند شناسه، توضیحات و URL است. اطلاعات اضافی در photo یا video بر اساس فراداده درون فایل است. ممکن است همه خواص وجود نداشته باشد.

اگر مورد رسانه یک ویدیو است، ابتدا باید فایل ویدیویی پردازش شود. mediaItem حاوی یک فیلد status در mediaMetadata است که وضعیت پردازش فایل ویدیویی را توصیف می کند. فایلی که به تازگی آپلود شده است، قبل از READY برای استفاده، ابتدا videoProcessingStatus با مقدار PROCESSING برمی گرداند. baseUrl یک مورد رسانه ویدیویی تا زمانی که ویدیو پردازش نشود در دسترس نیست.

GET https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "photo": {
       "cameraMake": "make-of-the-camera",
       "cameraModel": "model-of-the-camera",
       "focalLength": "focal-length-of-the-camera-lens",
       "apertureFNumber": "aperture-f-number-of-the-camera-lens",
       "isoEquivalent": "iso-of-the-camera",
       "exposureTime": "exposure-time-of-the-camera-aperture"
    }
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "video": {
     "cameraMake": "make-of-the-camera",
     "cameraModel": "model-of-the-camera",
     "fps": "frame-rate-of-the-video",
     "status": "READY"
    },
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

چندین آیتم رسانه ای دریافت کنید

برای بازیابی چندین آیتم رسانه با شناسه آنها، mediaItems.batchGet را با استفاده از mediaItemId s فراخوانی کنید.

این درخواست فهرستی از MediaItemResults را به ترتیب شناسه های آیتم های رسانه ارائه شده در درخواست برمی گرداند. هر نتیجه حاوی یک MediaItem یا یک Status در صورت وجود خطا است.

حداکثر تعداد آیتم های رسانه ای که می توانید در یک تماس درخواست کنید 50 مورد است. فهرست آیتم های رسانه ای نباید دارای شناسه های تکراری باشد و نمی تواند خالی باشد.

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet?mediaItemIds=media-item-id&mediaItemIds=another-media-item-id&mediaItemIds=incorrect-media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "mediaItemResults": [
    {
      "mediaItem": {
        "id": "media-item-id",
        ...
      }
    },
    {
      "mediaItem": {
        "id": "another-media-item-id",
        ...
      }
    },
    {
      "status": {
        "code": 3,
        "message": "Invalid media item ID."
      }
    }
  ]
}

URL های پایه

نشانی‌های وب پایه در APIهای Google Photos دسترسی به بایت‌های خام آیتم‌های رسانه را فراهم می‌کنند و برنامه شما را قادر می‌سازد آنها را دانلود یا نمایش دهد. این نشانی‌های وب هنگام فهرست کردن آلبوم‌ها (API کتابخانه) یا دسترسی به موارد رسانه (هم کتابخانه و هم API انتخابگر) در پاسخ‌ها گنجانده می‌شوند. به یاد داشته باشید، URL های پایه برای عملکرد صحیح به پارامترهای اضافی نیاز دارند.

برای Picker API:

همه اشیاء PickedMediaItem.mediaFile شامل یک baseUrl هستند.

URL های پایه به مدت 60 دقیقه فعال می مانند، اما اگر کاربر مجوزهای برنامه شما را از طریق تنظیمات حساب Google خود لغو کند، زودتر منقضی می شود.

برای کتابخانه API:

URL های پایه به مدت 60 دقیقه فعال می مانند.

URL های پایه مختلف عبارتند از:

• baseUrl : مستقیماً به عکس، تصویر کوچک یک ویدیو یا دانلود بایت های ویدیو دسترسی داشته باشید.
• coverPhotoBaseUrl : مستقیماً به عکس روی جلد آلبوم دسترسی پیدا کنید.
• profilePictureBaseUrl : مستقیماً به عکس نمایه صاحب یک mediaItem دسترسی پیدا کنید.

URL های پایه تصویر

در اینجا لیستی از گزینه هایی است که می توانید با URL های پایه تصویر استفاده کنید:

base-url=wmax-width-hmax-height

https://lh3.googleusercontent.com/p/AF....VnnY=w2048-h1024

base-url=wmax-width-hmax-height-c

https://lh3.googleusercontent.com/p/AF....VnnY=w256-h256-c

base-url=d

https://lh3.googleusercontent.com/p/Az....XabC=d

URL های پایه ویدیو

در اینجا لیستی از گزینه هایی است که می توانید با URL های پایه ویدیو استفاده کنید:

base-url=dv

https://lh3.googleusercontent.com/p/AF....BsdZ=dv

base-url=wmax-width-hmax-height-no

https://lh3.googleusercontent.com/p/AF....VnnY=w1280-h720-no

URL های پایه عکس متحرک

عکس‌های متحرک شامل عناصر عکس و ویدیو هستند. می‌توانید از پارامترهای URLهای پایه تصویر یا URLهای پایه ویدیو برای درخواست‌های baseUrl عکس متحرک استفاده کنید.

پس از برقراری تماس برای فهرست کردن محتویات یک کتابخانه یا آلبوم عکس ، به جای ذخیره آیتم های رسانه برگشتی، برنامه شما باید شناسه موارد رسانه را ذخیره کند. این به این دلیل است که محتوای آیتم های رسانه ممکن است تغییر کند و پس از مدتی مشخص، URL های موجود در پاسخ منقضی شوند. شناسه مورد رسانه به طور منحصربه‌فرد یک مورد رسانه مانند یک عکس یا یک ویدیو در کتابخانه کاربر را شناسایی می‌کند.

محدوده مجوز مورد نیاز

دسترسی به موارد رسانه ایجاد شده توسط برنامه به محدوده photoslibrary.readonly.appcreateddata نیاز دارد. برای اطلاعات بیشتر در مورد دامنه ها، به محدوده مجوز مراجعه کنید.

آیتم های رسانه ای

mediaItem نمایشی از رسانه هایی مانند عکس یا ویدیویی است که در کتابخانه Google Photos آپلود شده است. این یک شی سطح بالا است و ویژگی های آن می تواند بر اساس نوع رسانه زیرین متفاوت باشد.

جدول زیر ویژگی های mediaItem را فهرست می کند:

یک آیتم رسانه ای دریافت کنید

برای بازیابی یک مورد رسانه، با mediaItems.get با استفاده از mediaItemId تماس بگیرید. درخواست یک مورد رسانه ای را برمی گرداند.

mediaItem دارای ویژگی هایی مانند شناسه، توضیحات و URL است. اطلاعات اضافی در photo یا video بر اساس فراداده درون فایل است. ممکن است همه خواص وجود نداشته باشد.

اگر مورد رسانه یک ویدیو است، ابتدا باید فایل ویدیویی پردازش شود. mediaItem حاوی یک فیلد status در mediaMetadata است که وضعیت پردازش فایل ویدیویی را توصیف می کند. فایلی که به تازگی آپلود شده است، قبل از READY برای استفاده، ابتدا videoProcessingStatus با مقدار PROCESSING برمی گرداند. baseUrl یک مورد رسانه ویدیویی تا زمانی که ویدیو پردازش نشود در دسترس نیست.

GET https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "photo": {
       "cameraMake": "make-of-the-camera",
       "cameraModel": "model-of-the-camera",
       "focalLength": "focal-length-of-the-camera-lens",
       "apertureFNumber": "aperture-f-number-of-the-camera-lens",
       "isoEquivalent": "iso-of-the-camera",
       "exposureTime": "exposure-time-of-the-camera-aperture"
    }
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "video": {
     "cameraMake": "make-of-the-camera",
     "cameraModel": "model-of-the-camera",
     "fps": "frame-rate-of-the-video",
     "status": "READY"
    },
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

چندین آیتم رسانه ای دریافت کنید

برای بازیابی چندین آیتم رسانه با شناسه آنها، mediaItems.batchGet را با استفاده از mediaItemId s فراخوانی کنید.

این درخواست فهرستی از MediaItemResults را به ترتیب شناسه های آیتم های رسانه ارائه شده در درخواست برمی گرداند. هر نتیجه حاوی یک MediaItem یا یک Status در صورت وجود خطا است.

حداکثر تعداد آیتم های رسانه ای که می توانید در یک تماس درخواست کنید 50 مورد است. فهرست آیتم های رسانه ای نباید دارای شناسه های تکراری باشد و نمی تواند خالی باشد.

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet?mediaItemIds=media-item-id&mediaItemIds=another-media-item-id&mediaItemIds=incorrect-media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "mediaItemResults": [
    {
      "mediaItem": {
        "id": "media-item-id",
        ...
      }
    },
    {
      "mediaItem": {
        "id": "another-media-item-id",
        ...
      }
    },
    {
      "status": {
        "code": 3,
        "message": "Invalid media item ID."
      }
    }
  ]
}

URL های پایه

نشانی‌های وب پایه در APIهای Google Photos دسترسی به بایت‌های خام آیتم‌های رسانه را فراهم می‌کنند و برنامه شما را قادر می‌سازد آنها را دانلود یا نمایش دهد. این نشانی‌های وب هنگام فهرست کردن آلبوم‌ها (API کتابخانه) یا دسترسی به موارد رسانه (هم کتابخانه و هم API انتخابگر) در پاسخ‌ها گنجانده می‌شوند. به یاد داشته باشید، URL های پایه برای عملکرد صحیح به پارامترهای اضافی نیاز دارند.

برای Picker API:

همه اشیاء PickedMediaItem.mediaFile شامل یک baseUrl هستند.

URL های پایه به مدت 60 دقیقه فعال می مانند، اما اگر کاربر مجوزهای برنامه شما را از طریق تنظیمات حساب Google خود لغو کند، زودتر منقضی می شود.

برای کتابخانه API:

URL های پایه به مدت 60 دقیقه فعال می مانند.

URL های پایه مختلف عبارتند از:

• baseUrl : مستقیماً به عکس، تصویر کوچک یک ویدیو یا دانلود بایت های ویدیو دسترسی داشته باشید.
• coverPhotoBaseUrl : مستقیماً به عکس روی جلد آلبوم دسترسی پیدا کنید.
• profilePictureBaseUrl : مستقیماً به عکس نمایه صاحب یک mediaItem دسترسی پیدا کنید.

URL های پایه تصویر

در اینجا لیستی از گزینه هایی است که می توانید با URL های پایه تصویر استفاده کنید:

base-url=wmax-width-hmax-height

https://lh3.googleusercontent.com/p/AF....VnnY=w2048-h1024

base-url=wmax-width-hmax-height-c

https://lh3.googleusercontent.com/p/AF....VnnY=w256-h256-c

base-url=d

https://lh3.googleusercontent.com/p/Az....XabC=d

URL های پایه ویدیو

در اینجا لیستی از گزینه هایی است که می توانید با URL های پایه ویدیو استفاده کنید:

base-url=dv

https://lh3.googleusercontent.com/p/AF....BsdZ=dv

base-url=wmax-width-hmax-height-no

https://lh3.googleusercontent.com/p/AF....VnnY=w1280-h720-no

URL های پایه عکس متحرک

عکس‌های متحرک شامل عناصر عکس و ویدیو هستند. می‌توانید از پارامترهای URLهای پایه تصویر یا URLهای پایه ویدیو برای درخواست‌های baseUrl عکس متحرک استفاده کنید.

پس از برقراری تماس برای فهرست کردن محتویات یک کتابخانه یا آلبوم عکس ، به جای ذخیره آیتم های رسانه برگشتی، برنامه شما باید شناسه موارد رسانه را ذخیره کند. این به این دلیل است که محتوای آیتم های رسانه ممکن است تغییر کند و پس از مدتی مشخص، URL های موجود در پاسخ منقضی شوند. شناسه مورد رسانه به طور منحصربه‌فرد یک مورد رسانه مانند یک عکس یا یک ویدیو در کتابخانه کاربر را شناسایی می‌کند.

محدوده مجوز مورد نیاز

دسترسی به موارد رسانه ایجاد شده توسط برنامه به محدوده photoslibrary.readonly.appcreateddata نیاز دارد. برای اطلاعات بیشتر در مورد دامنه ها، به محدوده مجوز مراجعه کنید.

آیتم های رسانه ای

mediaItem نمایشی از رسانه هایی مانند عکس یا ویدیویی است که در کتابخانه Google Photos آپلود شده است. این یک شی سطح بالا است و ویژگی های آن می تواند بر اساس نوع رسانه زیرین متفاوت باشد.

جدول زیر ویژگی های mediaItem را فهرست می کند:

یک آیتم رسانه ای دریافت کنید

برای بازیابی یک مورد رسانه، با mediaItems.get با استفاده از mediaItemId تماس بگیرید. درخواست یک مورد رسانه ای را برمی گرداند.

mediaItem دارای ویژگی هایی مانند شناسه، توضیحات و URL است. اطلاعات اضافی در photo یا video بر اساس فراداده درون فایل است. ممکن است همه خواص وجود نداشته باشد.

اگر مورد رسانه یک ویدیو است، ابتدا باید فایل ویدیویی پردازش شود. mediaItem حاوی یک فیلد status در mediaMetadata است که وضعیت پردازش فایل ویدیویی را توصیف می کند. فایلی که به تازگی آپلود شده است، قبل از READY برای استفاده، ابتدا videoProcessingStatus با مقدار PROCESSING برمی گرداند. baseUrl یک مورد رسانه ویدیویی تا زمانی که ویدیو پردازش نشود در دسترس نیست.

GET https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "photo": {
       "cameraMake": "make-of-the-camera",
       "cameraModel": "model-of-the-camera",
       "focalLength": "focal-length-of-the-camera-lens",
       "apertureFNumber": "aperture-f-number-of-the-camera-lens",
       "isoEquivalent": "iso-of-the-camera",
       "exposureTime": "exposure-time-of-the-camera-aperture"
    }
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "video": {
     "cameraMake": "make-of-the-camera",
     "cameraModel": "model-of-the-camera",
     "fps": "frame-rate-of-the-video",
     "status": "READY"
    },
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

چندین آیتم رسانه ای دریافت کنید

برای بازیابی چندین آیتم رسانه با شناسه آنها، mediaItems.batchGet را با استفاده از mediaItemId s فراخوانی کنید.

این درخواست فهرستی از MediaItemResults را به ترتیب شناسه های آیتم های رسانه ارائه شده در درخواست برمی گرداند. هر نتیجه حاوی یک MediaItem یا یک Status در صورت وجود خطا است.

حداکثر تعداد آیتم های رسانه ای که می توانید در یک تماس درخواست کنید 50 مورد است. فهرست آیتم های رسانه ای نباید دارای شناسه های تکراری باشد و نمی تواند خالی باشد.

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet?mediaItemIds=media-item-id&mediaItemIds=another-media-item-id&mediaItemIds=incorrect-media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "mediaItemResults": [
    {
      "mediaItem": {
        "id": "media-item-id",
        ...
      }
    },
    {
      "mediaItem": {
        "id": "another-media-item-id",
        ...
      }
    },
    {
      "status": {
        "code": 3,
        "message": "Invalid media item ID."
      }
    }
  ]
}

URL های پایه

نشانی‌های وب پایه در APIهای Google Photos دسترسی به بایت‌های خام آیتم‌های رسانه را فراهم می‌کنند و برنامه شما را قادر می‌سازد آنها را دانلود یا نمایش دهد. این نشانی‌های وب هنگام فهرست کردن آلبوم‌ها (API کتابخانه) یا دسترسی به موارد رسانه (هم کتابخانه و هم API انتخابگر) در پاسخ‌ها گنجانده می‌شوند. به یاد داشته باشید، URL های پایه برای عملکرد صحیح به پارامترهای اضافی نیاز دارند.

برای Picker API:

همه اشیاء PickedMediaItem.mediaFile شامل یک baseUrl هستند.

URL های پایه به مدت 60 دقیقه فعال می مانند، اما اگر کاربر مجوزهای برنامه شما را از طریق تنظیمات حساب Google خود لغو کند، زودتر منقضی می شود.

برای کتابخانه API:

URL های پایه به مدت 60 دقیقه فعال می مانند.

URL های پایه مختلف عبارتند از:

• baseUrl : مستقیماً به عکس، تصویر کوچک یک ویدیو یا دانلود بایت های ویدیو دسترسی داشته باشید.
• coverPhotoBaseUrl : مستقیماً به عکس روی جلد آلبوم دسترسی پیدا کنید.
• profilePictureBaseUrl : مستقیماً به عکس نمایه صاحب یک mediaItem دسترسی پیدا کنید.

URL های پایه تصویر

در اینجا لیستی از گزینه هایی است که می توانید با URL های پایه تصویر استفاده کنید:

base-url=wmax-width-hmax-height

https://lh3.googleusercontent.com/p/AF....VnnY=w2048-h1024

base-url=wmax-width-hmax-height-c

https://lh3.googleusercontent.com/p/AF....VnnY=w256-h256-c

base-url=d

https://lh3.googleusercontent.com/p/Az....XabC=d

URL های پایه ویدیو

در اینجا لیستی از گزینه هایی است که می توانید با URL های پایه ویدیو استفاده کنید:

base-url=dv

https://lh3.googleusercontent.com/p/AF....BsdZ=dv

base-url=wmax-width-hmax-height-no

https://lh3.googleusercontent.com/p/AF....VnnY=w1280-h720-no

URL های پایه عکس متحرک

عکس‌های متحرک شامل عناصر عکس و ویدیو هستند. می‌توانید از پارامترهای URLهای پایه تصویر یا URLهای پایه ویدیو برای درخواست‌های baseUrl عکس متحرک استفاده کنید.