คุณกำลังดูเอกสารประกอบเดิมสำหรับ Google Photos Library API

หน้านี้ได้รับการแปลโดย Cloud Translation API

เข้าถึงรายการสื่อ

หลังจากโทรหา แสดงเนื้อหาในคลังภาพหรืออัลบั้ม แทนที่จะจัดเก็บรายการสื่อที่ส่งคืน แอปพลิเคชันของคุณควรจัดเก็บ รหัสของรายการสื่อ เนื่องจากเนื้อหาของรายการสื่ออาจเปลี่ยนแปลงไป และ URL ที่รวมอยู่ในการตอบกลับจะหมดอายุหลังจากผ่านไประยะหนึ่ง รหัสรายการสื่อจะระบุรายการสื่ออย่างเจาะจง เช่น รูปภาพหรือวิดีโอ ในคลังภาพของผู้ใช้

โปรดทราบว่าแอปพลิเคชันไม่ควรแคชรูปภาพหรือวิดีโอของผู้ใช้เป็นเวลานาน แต่คุณจัดเก็บหรือแคชรหัสรายการสื่อได้นานเท่าที่จำเป็น ทั้งนี้ขึ้นอยู่กับกรณีการใช้งาน นอกจากนี้ โปรดทราบว่าการเข้าถึงข้อมูลผู้ใช้อยู่ภายใต้ภาระหน้าที่ด้านความเป็นส่วนตัว

ขอบเขตการให้สิทธิ์ที่จำเป็น

หากต้องการเข้าถึงรายการสื่อ แอปของคุณต้องขอรายการต่อไปนี้อย่างน้อย 1 รายการ ขอบเขตการให้สิทธิ์ สิทธิ์เข้าถึงรายการสื่อที่แสดงในการตอบกลับจะขึ้นอยู่กับขอบเขตที่คุณ ได้ส่งคำขอ

photoslibrary.readonly อนุญาตให้เข้าถึงรายการสื่อทั้งหมดในคลังภาพของผู้ใช้
photoslibrary.readonly.appcreateddata อนุญาตให้เข้าถึงเฉพาะรายการสื่อที่แอปสร้างขึ้น

รายการสื่อ

ต mediaItem คือการนำเสนอสื่อ เช่น รูปภาพหรือวิดีโอ ที่อัปโหลดไปยัง คลังภาพ Google Photos เป็นออบเจ็กต์ระดับบนสุดและพร็อพเพอร์ตี้ของออบเจ็กต์สามารถ จะแตกต่างกันไปตามประเภทสื่อ

ตารางต่อไปนี้แสดงรายการพร็อพเพอร์ตี้ mediaItem

พร็อพเพอร์ตี้
`id`	รหัสแบบคงที่ถาวรที่ใช้ระบุออบเจ็กต์
`description`	คำอธิบายรายการสื่อตามที่เห็นใน Google Photos
`baseUrl`	ใช้เพื่อเข้าถึงไบต์ดิบ สำหรับข้อมูลเพิ่มเติม โปรดดูที่ URL หลัก
`productUrl`	ลิงก์ไปยังรูปภาพใน Google Photos ลิงก์นี้ไม่สามารถ เปิดโดยนักพัฒนาซอฟต์แวร์ โดยผู้ใช้เท่านั้น URL ชี้ไปที่รายการสื่อใน ไลบรารี หากดึงข้อมูล URL จากการค้นหาอัลบั้ม URL จะชี้ไปยังรายการภายในอัลบั้ม
`mimeType`	ประเภทของรายการสื่อเพื่อช่วยให้ระบุประเภทสื่อได้โดยง่าย (เช่น `image/jpg`)
`filename`	ชื่อไฟล์ของรายการสื่อที่แสดงต่อผู้ใช้ในแอป Google Photos (ภายในส่วนข้อมูลของรายการ)
`mediaMetadata`	แตกต่างกันไปตามประเภทของสื่อ เช่น `photo` หรือ `video` คุณสามารถใช้มาสก์ช่องเพื่อลดเพย์โหลดได้
`contributorInfo`	ช่องนี้จะสร้างขึ้นก็ต่อเมื่อรายการสื่ออยู่ในอัลบั้มที่แชร์ซึ่งสร้างโดยแอปนี้และผู้ใช้ได้ให้สิทธิ์`photoslibrary.sharing` มีข้อมูลเกี่ยวกับผู้มีส่วนร่วมที่เพิ่มรายการสื่อนี้ โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อแชร์สื่อ

รับรายการสื่อ

หากต้องการเรียกรายการสื่อ ให้เรียกใช้ mediaItems.get โดยใช้ mediaItemId คำขอแสดงรายการสื่อรายการเดียว

mediaItem มีพร็อพเพอร์ตี้ เช่น รหัส คำอธิบาย และ URL ข้อมูลเพิ่มเติมภายใน photo หรือ video จะอิงตามข้อมูลเมตาภายในไฟล์ อาจไม่มีที่พักบางแห่ง ContributorInfo มีข้อมูลเมตาสำหรับรายการที่เป็นส่วนหนึ่งของอัลบั้มที่แชร์ ช่องนี้จะมีเฉพาะในกรณีที่ แสดงเนื้อหาของ อัลบั้มที่แชร์ที่ผู้ใช้ได้ให้สิทธิ์ photoslibrary.sharing ขอบเขตการให้สิทธิ์

หากรายการสื่อเป็นวิดีโอ ระบบจะต้องประมวลผลไฟล์วิดีโอก่อน mediaItem มีช่อง status ภายใน mediaMetadata ซึ่งอธิบายถึง สถานะการประมวลผลไฟล์วิดีโอ ไฟล์ที่อัปโหลดใหม่จะแสดง videoProcessingStatus ที่มีค่า PROCESSING ก่อน จากนั้นจึงREADYเพื่อใช้งาน baseUrl ของรายการสื่อวิดีโอจะใช้งานไม่ได้จนกว่าระบบจะประมวลผลวิดีโอ

REST

คำขอ GET มีดังนี้

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"
  }
}

Java

พร็อพเพอร์ตี้รูปภาพมีข้อมูลเมตาสำหรับรายการรูปภาพ

try {
  // Get a media item using its ID
  String mediaItemId = "...";
  MediaItem item = photosLibraryClient.getMediaItem(mediaItemId);
  // Get some properties from the retrieved media item
  String id = item.getId();
  String description = item.getDescription();
  String baseUrl = item.getBaseUrl();
  String productUrl = item.getProductUrl();
  // ...
  if (item.hasMediaMetadata()) {
    // The media item contains additional metadata, such as the height and width
    MediaMetadata metadata = item.getMediaMetadata();
    long height = metadata.getHeight();
    long width = metadata.getWidth();
    Timestamp creationTime = metadata.getCreationTime();
    // ...
    if (metadata.hasPhoto()) {
      // This media item is a photo and has additional photo metadata
      Photo photoMetadata = metadata.getPhoto();
      String cameraMake = photoMetadata.getCameraMake();
      String cameraModel = photoMetadata.getCameraModel();
      float aperture = photoMetadata.getApertureFNumber();
      int isoEquivalent = photoMetadata.getIsoEquivalent();
      // ...
    }
  }
  if (item.hasContributorInfo()) {
    // A user has contributed this media item  to a shared album
    ContributorInfo contributorInfo = item.getContributorInfo();
    String profilePictureBaseUrl = contributorInfo.getProfilePictureBaseUrl();
    String displayName = contributorInfo.getDisplayName();
  }
} catch (ApiException e) {
  // Handle error
}

พร็อพเพอร์ตี้วิดีโอมีข้อมูลเมตาสำหรับรายการวิดีโอ

try {
  // Get a media item using its ID
  String mediaItemId = "...";
  MediaItem item = photosLibraryClient.getMediaItem(mediaItemId);
  // Get some properties from the retrieved media item
  String id = item.getId();
  String description = item.getDescription();
  String baseUrl = item.getBaseUrl();
  String productUrl = item.getProductUrl();
  // ...
  if (item.hasMediaMetadata()) {
    // The media item contains additional metadata, such as the height and width
    MediaMetadata metadata = item.getMediaMetadata();
    long height = metadata.getHeight();
    long width = metadata.getWidth();
    Timestamp creationTime = metadata.getCreationTime();
    // ...

    if (metadata.hasVideo()) {
      // This media item is a video and has additional video metadata
      Video videoMetadata = metadata.getVideo();
      VideoProcessingStatus status = videoMetadata.getStatus();
      if (status.equals(VideoProcessingStatus.READY)) {
        // This video media item has been processed
        String cameraMake = videoMetadata.getCameraMake();
        String cameraModel = videoMetadata.getCameraModel();
        double fps = videoMetadata.getFps();
        // ...
      }
    }
  }

  if (item.hasContributorInfo()) {
    // A user has contributed this media item  to a shared album
    ContributorInfo contributorInfo = item.getContributorInfo();
    String profilePictureBaseUrl = contributorInfo.getProfilePictureBaseUrl();
    String displayName = contributorInfo.getDisplayName();
  }
} catch (ApiException e) {
  // Handle error
}

PHP

พร็อพเพอร์ตี้รูปภาพมีข้อมูลเมตาสำหรับรายการรูปภาพ

try {
    // Get a media item using its ID
    $mediaItemId = "...";
    $item = $photosLibraryClient->getMediaItem($mediaItemId);
    // Get some properties from the retrieved media item
    $id = $item->getId();
    $description = $item->getDescription();
    $baseUrl = $item->getBaseUrl();
    $productUrl = $item->getProductUrl();
    // ...
    $metadata = $item->getMediaMetadata();
    if (!is_null($metadata)) {
        // The media item contains additional metadata, such as the height and width
        $height = $metadata->getHeight();
        $width = $metadata->getWidth();
        $creationTime = $metadata->getCreationTime();
        // ...
        $photoMetadata = $metadata->getPhoto();
        if (!is_null($photoMetadata)) {
            // This media item is a photo and has additional photo metadata
            $cameraMake = $photoMetadata->getCameraMake();
            $cameraModel = $photoMetadata->getCameraModel();
            $aperture = $photoMetadata->getApertureFNumber();
            $isoEquivalent = $photoMetadata->getIsoEquivalent();
            // ...
        }
    }
    $contributorInfo = $item->getContributorInfo();
    if (!is_null($contributorInfo)) {
        // A user has contributed this media item to a shared album
        $profilePictureBaseUrl = $contributorInfo->getProfilePictureBaseUrl();
        $displayName = $contributorInfo->getDisplayName();
    }
} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}

พร็อพเพอร์ตี้วิดีโอมีข้อมูลเมตาสำหรับรายการวิดีโอ

  try {
    // Get a media item using its ID
    $mediaItemId = "...";
    $item = $photosLibraryClient->getMediaItem($mediaItemId);
    // Get some properties from the retrieved media item
    $id = $item->getId();
    $description = $item->getDescription();
    $baseUrl = $item->getBaseUrl();
    $productUrl = $item->getProductUrl();
    // ...
    $metadata = $item->getMediaMetadata();
    if (!is_null($metadata)) {
        // The media item contains additional metadata, such as the height and width
        $height = $metadata->getHeight();
        $width = $metadata->getWidth();
        $creationTime = $metadata->getCreationTime();
        // ...
        $videoMetadata = $metadata->getVideo();
        if (!is_null($videoMetadata)) {
            // This media item is a video and has additional video metadata
            if (VideoProcessingStatus::READY == $videoMetadata->getStatus()) {
            // This video media item has been processed
                $cameraMake = $videoMetadata->getCameraMake();
                $cameraModel = $videoMetadata->getCameraModel();
                $fps = $videoMetadata->getFps();
                // ...
            }
        }
    }
    $contributorInfo = $item->getContributorInfo();
    if (!is_null($contributorInfo)) {
        // A user has contributed this media item to a shared album
        $profilePictureBaseUrl = $contributorInfo->getProfilePictureBaseUrl();
        $displayName = $contributorInfo->getDisplayName();
    }
} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}

รับรายการสื่อหลายรายการ

หากต้องการเรียกข้อมูลรายการสื่อหลายรายการตามตัวระบุ ให้เรียกใช้ mediaItems.batchGet โดยใช้ mediaItemId

คำขอจะแสดงรายการ MediaItemResults ตามลําดับของตัวระบุรายการสื่อที่ระบุในคําขอ ผลลัพธ์แต่ละรายการ มี MediaItem หรือ Status หากมีข้อผิดพลาด

จำนวนรายการสื่อสูงสุดที่คุณขอได้ในคอลเดียวคือ 50 รายการ รายการ รายการสื่อต้องไม่มีตัวระบุที่ซ้ำกันและต้องไม่ว่างเปล่า

REST

นี่คือคำขอ GET ที่แสดงการเข้าถึงที่สำเร็จและไม่สำเร็จของ รายการสื่อ ระบุตัวระบุรายการสื่อแต่ละรายการเป็นพารามิเตอร์การค้นหา mediaItemIds ใหม่เป็นส่วนหนึ่งของคําขอ

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

คำขอ GET จะแสดงผลลัพธ์ต่อไปนี้

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

Java

try {
  // List of media item IDs to retrieve
  List<String> mediaItemIds = Arrays
      .asList("MEDIA_ITEM_ID", "ANOTHER_MEDIA_ITEM_ID", "INCORRECT_MEDIA_ITEM_ID");

  // Get a list of media items using their IDs
  BatchGetMediaItemsResponse response = photosLibraryClient
      .batchGetMediaItems(mediaItemIds);

  // Loop over each result
  for (MediaItemResult result : response.getMediaItemResultsList()) {

    // Each MediaItemresult contains a status and a media item
    if (result.hasMediaItem()) {
      // The media item was successfully retrieved, get some properties
      MediaItem item = result.getMediaItem();
      String id = item.getId();
      // ...
    } else {
      // If the media item is not set, an error occurred and the item could not be loaded
      // Check the status and handle the error
      Status status = result.getStatus();
      // ...
    }

  }
} catch (ApiException e) {
  // Handle error
}

PHP

try {

    // List of media item IDs to retrieve
    $mediaItemIds = ["MEDIA_ITEM_ID", "ANOTHER_MEDIA_ITEM_ID", "INCORRECT_MEDIA_ITEM_ID"];

    // Get a list of media items using their IDs
    $response = $photosLibraryClient->batchGetMediaItems($mediaItemIds);

    // Loop over each result
    foreach ($response->getMediaItemResults() as $itemResult) {

        // Each MediaItemresult contains a status and a media item
        $mediaItem = $itemResult->getMediaItem();

        if(!is_null($mediaItem)){
            // The media item was successfully retrieved, get some properties
            $id = $mediaItem->getId();
            // ...
        } else {
            // If the media item is null, an error occurred and the item could not be loaded
        }
    }

} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}

URL ฐาน

URL พื้นฐานภายใน Google Photos Library API ช่วยให้คุณเข้าถึงไบต์ของรายการสื่อได้ การใช้ URL ฐานที่หลากหลายจะทำให้แอปของคุณดาวน์โหลดรายการสื่อได้ หรือแสดงรายการสื่อภายในแอป URL ฐานคือสตริงที่ รวมอยู่ในคำตอบเมื่อคุณแสดงอัลบั้มหรือเข้าถึงรายการสื่อ โดยจะมีผลเป็นเวลา 60 นาที และต้องมีพารามิเตอร์เพิ่มเติมเนื่องจากไม่สามารถใช้งานได้ตามที่เป็นอยู่

URL พื้นฐานต่างๆ ได้แก่

baseUrl: เข้าถึงรูปภาพ ภาพขนาดย่อสำหรับวิดีโอ หรือไบต์ข้อมูลดาวน์โหลดของวิดีโอได้โดยตรง
coverPhotoBaseUrl: เข้าถึงรูปภาพปกของอัลบั้มโดยตรง
profilePictureBaseUrl: เข้าถึงรูปโปรไฟล์ของเจ้าของ mediaItem โดยตรง

URL ฐานของรูปภาพ

รายการตัวเลือกที่คุณใช้ได้กับ URL พื้นฐานของรูปภาพมีดังนี้

พารามิเตอร์

พารามิเตอร์
`w` `h`	คำอธิบาย พารามิเตอร์ความกว้าง `w` และความสูง `h` หากต้องการเข้าถึงรายการสื่อรูปภาพ เช่น รูปภาพหรือภาพขนาดย่อของวิดีโอ คุณต้องระบุขนาดที่คุณวางแผนจะแสดงในแอปพลิเคชัน (เพื่อให้ปรับขนาดรูปภาพเป็นขนาดเหล่านี้ได้ขณะที่ยังคงรักษาสัดส่วนภาพเดิมไว้) โดยให้ต่อท้าย URL พื้นฐานด้วยมิติข้อมูลที่ต้องการตามที่แสดงในตัวอย่าง ตัวอย่างเช่น `base-url`=w`max-width`-h`max-height` ต่อไปนี้เป็นตัวอย่างสำหรับรายการสื่อที่ไม่กว้างกว่า 2048 พิกเซลและไม่เกิน 1024 พิกเซล https://lh3.googleusercontent.com/p/AF....VnnY=w2048-h1024
`c`	คำอธิบาย พารามิเตอร์ครอบตัด `c` หากต้องการครอบตัดรูปภาพให้มีความกว้างและความสูงที่ตรงกับขนาดที่คุณระบุ ให้ต่อ URL พื้นฐานกับพารามิเตอร์ `-c` ที่ไม่บังคับ พร้อมกับพารามิเตอร์ `w` และ `h` ที่ต้องระบุ ขนาด (เป็นพิกเซล) ควรอยู่ในช่วง [1, 16383] หากความกว้างหรือความสูงของรูปภาพเกินขนาดที่ขอ ระบบจะปรับขนาดรูปภาพให้เล็กลงและครอบตัด (โดยคงสัดส่วนภาพไว้) ตัวอย่างเช่น `base-url`=w`max-width`-h`max-height`-c ในตัวอย่างนี้ แอปพลิเคชันจะแสดงรายการสื่อที่ กว้าง 256 พิกเซล สูง 256 พิกเซล เช่น ภาพขนาดย่อ: https://lh3.googleusercontent.com/p/AF....VnnY=w256-h256-c
`d`	คำอธิบาย พารามิเตอร์การดาวน์โหลด `d` หากคุณต้องการดาวน์โหลดรูปภาพที่เก็บรักษาข้อมูลเมตา Exif ทั้งหมดไว้ ให้เชื่อมต่อ URL พื้นฐานด้วย พารามิเตอร์ `d` ตัวอย่างเช่น `base-url`=d ในตัวอย่างนี้ แอปพลิเคชันจะดาวน์โหลดรูปภาพที่มีข้อมูลเมตาทั้งหมด ยกเว้นข้อมูลเมตาตำแหน่ง https://lh3.googleusercontent.com/p/Az....XabC=d

w h

คำอธิบาย

พารามิเตอร์ความกว้าง w และความสูง h

หากต้องการเข้าถึงรายการสื่อรูปภาพ เช่น รูปภาพหรือภาพขนาดย่อของวิดีโอ คุณต้องระบุขนาดที่คุณวางแผนจะแสดงในแอปพลิเคชัน (เพื่อให้ปรับขนาดรูปภาพเป็นขนาดเหล่านี้ได้ขณะที่ยังคงรักษาสัดส่วนภาพเดิมไว้) โดยให้ต่อท้าย URL พื้นฐานด้วยมิติข้อมูลที่ต้องการตามที่แสดงในตัวอย่าง

ตัวอย่างเช่น

base-url=wmax-width-hmax-height

ต่อไปนี้เป็นตัวอย่างสำหรับรายการสื่อที่ไม่กว้างกว่า 2048 พิกเซลและไม่เกิน 1024 พิกเซล

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

c

คำอธิบาย

พารามิเตอร์ครอบตัด c

หากต้องการครอบตัดรูปภาพให้มีความกว้างและความสูงที่ตรงกับขนาดที่คุณระบุ ให้ต่อ URL พื้นฐานกับพารามิเตอร์ -c ที่ไม่บังคับ พร้อมกับพารามิเตอร์ w และ h ที่ต้องระบุ

ขนาด (เป็นพิกเซล) ควรอยู่ในช่วง [1, 16383] หากความกว้างหรือความสูงของรูปภาพเกินขนาดที่ขอ ระบบจะปรับขนาดรูปภาพให้เล็กลงและครอบตัด (โดยคงสัดส่วนภาพไว้)

ตัวอย่างเช่น

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

ในตัวอย่างนี้ แอปพลิเคชันจะแสดงรายการสื่อที่ กว้าง 256 พิกเซล สูง 256 พิกเซล เช่น ภาพขนาดย่อ:

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

d

คำอธิบาย

พารามิเตอร์การดาวน์โหลด d

หากคุณต้องการดาวน์โหลดรูปภาพที่เก็บรักษาข้อมูลเมตา Exif ทั้งหมดไว้ ให้เชื่อมต่อ URL พื้นฐานด้วย พารามิเตอร์ d

ตัวอย่างเช่น

base-url=d

ในตัวอย่างนี้ แอปพลิเคชันจะดาวน์โหลดรูปภาพที่มีข้อมูลเมตาทั้งหมด ยกเว้นข้อมูลเมตาตำแหน่ง

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

URL หลักของวิดีโอ

ต่อไปนี้เป็นรายการตัวเลือกที่คุณสามารถใช้กับ URL พื้นฐานของวิดีโอ

พารามิเตอร์

พารามิเตอร์
`dv`	คำอธิบาย หากต้องการเข้าถึงจำนวนไบต์ของวิดีโอ `mediaItem` ให้เชื่อมต่อ `baseUrl` พร้อมวิดีโอดาวน์โหลด `dv` พารามิเตอร์ พารามิเตอร์ dv จะขอวิดีโอต้นฉบับเวอร์ชันที่แปลงรูปแบบไว้แล้วและมีคุณภาพสูง พารามิเตอร์นี้ใช้ร่วมกับพารามิเตอร์ w และ h ไม่ได้ URL พื้นฐานสำหรับการดาวน์โหลดวิดีโออาจใช้เวลา 2-3 วินาทีในการแสดงผลไบต์ ก่อนใช้พารามิเตอร์นี้ ให้ตรวจสอบว่ารายการสื่อ ช่อง `mediaMetadata.status` คือ `READY` มิฉะนั้น หากรายการสื่อประมวลผลไม่เสร็จสิ้น คุณอาจได้รับข้อผิดพลาด ตัวอย่างเช่น `base-url`=`dv` ตัวอย่างต่อไปนี้แสดงวิธีดาวน์โหลดไบต์ของ วิดีโอ: https://lh3.googleusercontent.com/p/AF....BsdZ=dv
`w`, `h`, `c` และ `d`	คำอธิบาย หากต้องการเข้าถึงภาพปกของวิดีโอ ให้ใช้พารามิเตอร์ URL พื้นฐานของรูปภาพ โดยค่าเริ่มต้น ภาพขนาดย่อของวิดีโอทั้งหมดจะมีการวางซ้อนการเล่น ดูพารามิเตอร์ -no เพื่อนำการวางซ้อนนี้ออก ตัวอย่างเช่น โปรดดูตาราง URL ฐานของรูปภาพ เพื่อดูตัวอย่าง
`no`	คำอธิบาย พารามิเตอร์ `no` สำหรับนำการวางซ้อนภาพปกออก หากต้องการเรียกข้อมูลภาพปกของวิดีโอโดยไม่มีปุ่มเล่นที่วางซ้อน ให้ต่อ URL พื้นฐานกับพารามิเตอร์ no ต้องใช้พารามิเตอร์ no กับ เวลา พารามิเตอร์ URL ฐานของรูปภาพ ตัวอย่างเช่น `base-url`=w`max-width`-h`max-height`-no ตัวอย่างต่อไปนี้แสดงภาพขนาดย่อของวิดีโอที่มีความกว้าง 1280 พิกเซล x สูง 720 พิกเซลพอดี และไม่มีการซ้อนทับปุ่มเล่น https://lh3.googleusercontent.com/p/AF....VnnY=w1280-h720-no

dv

คำอธิบาย

หากต้องการเข้าถึงจำนวนไบต์ของวิดีโอ mediaItem ให้เชื่อมต่อ baseUrl พร้อมวิดีโอดาวน์โหลด dv พารามิเตอร์

พารามิเตอร์ dv จะขอวิดีโอต้นฉบับเวอร์ชันที่แปลงรูปแบบไว้แล้วและมีคุณภาพสูง พารามิเตอร์นี้ใช้ร่วมกับพารามิเตอร์ w และ h ไม่ได้

URL พื้นฐานสำหรับการดาวน์โหลดวิดีโออาจใช้เวลา 2-3 วินาทีในการแสดงผลไบต์

ก่อนใช้พารามิเตอร์นี้ ให้ตรวจสอบว่ารายการสื่อ ช่อง mediaMetadata.status คือ READY มิฉะนั้น หากรายการสื่อประมวลผลไม่เสร็จสิ้น คุณอาจได้รับข้อผิดพลาด

ตัวอย่างเช่น

base-url=dv

ตัวอย่างต่อไปนี้แสดงวิธีดาวน์โหลดไบต์ของ วิดีโอ:

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

w, h, c และ d

คำอธิบาย

หากต้องการเข้าถึงภาพปกของวิดีโอ ให้ใช้พารามิเตอร์ URL พื้นฐานของรูปภาพ

โดยค่าเริ่มต้น ภาพขนาดย่อของวิดีโอทั้งหมดจะมีการวางซ้อนการเล่น ดูพารามิเตอร์ -no เพื่อนำการวางซ้อนนี้ออก

ตัวอย่างเช่น

โปรดดูตาราง URL ฐานของรูปภาพ เพื่อดูตัวอย่าง

no

คำอธิบาย

พารามิเตอร์ no สำหรับนำการวางซ้อนภาพปกออก

หากต้องการเรียกข้อมูลภาพปกของวิดีโอโดยไม่มีปุ่มเล่นที่วางซ้อน ให้ต่อ URL พื้นฐานกับพารามิเตอร์ no

ต้องใช้พารามิเตอร์ no กับ เวลา พารามิเตอร์ URL ฐานของรูปภาพ

ตัวอย่างเช่น

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

ตัวอย่างต่อไปนี้แสดงภาพขนาดย่อของวิดีโอที่มีความกว้าง 1280 พิกเซล x สูง 720 พิกเซลพอดี และไม่มีการซ้อนทับปุ่มเล่น

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

URL พื้นฐานของรูปภาพเคลื่อนไหว

รูปภาพเคลื่อนไหวมีทั้งองค์ประกอบรูปภาพและวิดีโอ คุณสามารถใช้พารามิเตอร์จากURL ฐานรูปภาพหรือURL ฐานวิดีโอสำหรับคำขอภาพเคลื่อนไหว baseUrl

พารามิเตอร์

พารามิเตอร์
`dv`	คำอธิบาย หากต้องการดึงข้อมูลองค์ประกอบวิดีโอของรายการสื่อรูปภาพเคลื่อนไหว ให้ใช้ พารามิเตอร์ `dv` เหมือนกับที่คุณจะใช้ดาวน์โหลดจาก URL พื้นฐานของวิดีโอ
`w`, `h`, `c` และ `d`	คำอธิบาย หากต้องการดึงข้อมูลองค์ประกอบรูปภาพของรายการสื่อรูปภาพเคลื่อนไหว ให้ใช้ รูปแบบสำหรับ URL ฐานรูปภาพ

dv

คำอธิบาย

หากต้องการดึงข้อมูลองค์ประกอบวิดีโอของรายการสื่อรูปภาพเคลื่อนไหว ให้ใช้ พารามิเตอร์ dv เหมือนกับที่คุณจะใช้ดาวน์โหลดจาก URL พื้นฐานของวิดีโอ

w, h, c และ d

คำอธิบาย

หากต้องการดึงข้อมูลองค์ประกอบรูปภาพของรายการสื่อรูปภาพเคลื่อนไหว ให้ใช้ รูปแบบสำหรับ URL ฐานรูปภาพ