---
title: "GET /v1/media/{mediaId}"
method: GET
path: "/v1/media/{mediaId}"
tags: ["media"]
---

# GET /v1/media/{mediaId}

`GET /v1/media/{mediaId}`

## Request

- Base URL: `https://youtubereporting.googleapis.com`
- URL: `https://youtubereporting.googleapis.com/v1/media/{mediaId}`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/yt-analytics-monetary.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/yt-analytics-monetary.readonly`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/yt-analytics.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/yt-analytics.readonly`

Method for media download. Download is supported on the URI `/v1/media/{+name}?alt=media`.

## Path parameters

- `mediaId` string, required

## Response `200`

Successful response

- GdataMedia: gdata
  - `algorithm` string: gdata
  - `bigstoreObjectRef` string, byte: gdata
  - `blobRef` string, byte: gdata
  - `blobstore2Info` GdataBlobstore2Info: gdata
    - `blobGeneration` string, int64: gdata
    - `blobId` string: gdata
    - `downloadExternalReadToken` string, byte: gdata
    - `downloadReadHandle` string, byte: gdata
    - `readToken` string: gdata
    - `uploadFragmentListCreationInfo` string, byte: gdata
    - `uploadMetadataContainer` string, byte: gdata
  - `compositeMedia` GdataCompositeMedia[]: gdata
    - `blobRef` string, byte: gdata
    - `blobstore2Info` GdataBlobstore2Info: gdata
      - `blobGeneration` string, int64: gdata
      - `blobId` string: gdata
      - `downloadExternalReadToken` string, byte: gdata
      - `downloadReadHandle` string, byte: gdata
      - `readToken` string: gdata
      - `uploadFragmentListCreationInfo` string, byte: gdata
      - `uploadMetadataContainer` string, byte: gdata
    - `cosmoBinaryReference` string, byte: gdata
    - `crc32cHash` integer: gdata
    - `inline` string, byte: gdata
    - `length` string, int64: gdata
    - `md5Hash` string, byte: gdata
    - `objectId` GdataObjectId: gdata
      - `bucketName` string: gdata
      - `generation` string, int64: gdata
      - `objectName` string: gdata
    - `path` string: gdata
    - `referenceType` 'PATH' | 'BLOB_REF' | 'INLINE' | 'BIGSTORE_REF' | 'COSMO_BINARY_REFERENCE': gdata
    - `sha1Hash` string, byte: gdata
  - `contentType` string: gdata
  - `contentTypeInfo` GdataContentTypeInfo: gdata
    - `bestGuess` string: gdata
    - `fromBytes` string: gdata
    - `fromFileName` string: gdata
    - `fromFusionId` string: gdata
    - `fromHeader` string: gdata
    - `fromUrlPath` string: gdata
    - `fusionIdDetectionMetadata` string, byte: gdata
  - `cosmoBinaryReference` string, byte: gdata
  - `crc32cHash` integer: gdata
  - `diffChecksumsResponse` GdataDiffChecksumsResponse: gdata
    - `checksumsLocation` GdataCompositeMedia: gdata
      - `blobRef` string, byte: gdata
      - `blobstore2Info` GdataBlobstore2Info: gdata
        - `blobGeneration` string, int64: gdata
        - `blobId` string: gdata
        - `downloadExternalReadToken` string, byte: gdata
        - `downloadReadHandle` string, byte: gdata
        - `readToken` string: gdata
        - `uploadFragmentListCreationInfo` string, byte: gdata
        - `uploadMetadataContainer` string, byte: gdata
      - `cosmoBinaryReference` string, byte: gdata
      - `crc32cHash` integer: gdata
      - `inline` string, byte: gdata
      - `length` string, int64: gdata
      - `md5Hash` string, byte: gdata
      - `objectId` GdataObjectId: gdata
        - `bucketName` string: gdata
        - `generation` string, int64: gdata
        - `objectName` string: gdata
      - `path` string: gdata
      - `referenceType` 'PATH' | 'BLOB_REF' | 'INLINE' | 'BIGSTORE_REF' | 'COSMO_BINARY_REFERENCE': gdata
      - `sha1Hash` string, byte: gdata
    - `chunkSizeBytes` string, int64: gdata
    - `objectLocation` GdataCompositeMedia: gdata
      - `blobRef` string, byte: gdata
      - `blobstore2Info` GdataBlobstore2Info: gdata
        - `blobGeneration` string, int64: gdata
        - `blobId` string: gdata
        - `downloadExternalReadToken` string, byte: gdata
        - `downloadReadHandle` string, byte: gdata
        - `readToken` string: gdata
        - `uploadFragmentListCreationInfo` string, byte: gdata
        - `uploadMetadataContainer` string, byte: gdata
      - `cosmoBinaryReference` string, byte: gdata
      - `crc32cHash` integer: gdata
      - `inline` string, byte: gdata
      - `length` string, int64: gdata
      - `md5Hash` string, byte: gdata
      - `objectId` GdataObjectId: gdata
        - `bucketName` string: gdata
        - `generation` string, int64: gdata
        - `objectName` string: gdata
      - `path` string: gdata
      - `referenceType` 'PATH' | 'BLOB_REF' | 'INLINE' | 'BIGSTORE_REF' | 'COSMO_BINARY_REFERENCE': gdata
      - `sha1Hash` string, byte: gdata
    - `objectSizeBytes` string, int64: gdata
    - `objectVersion` string: gdata
  - `diffDownloadResponse` GdataDiffDownloadResponse: gdata
    - `objectLocation` GdataCompositeMedia: gdata
      - `blobRef` string, byte: gdata
      - `blobstore2Info` GdataBlobstore2Info: gdata
        - `blobGeneration` string, int64: gdata
        - `blobId` string: gdata
        - `downloadExternalReadToken` string, byte: gdata
        - `downloadReadHandle` string, byte: gdata
        - `readToken` string: gdata
        - `uploadFragmentListCreationInfo` string, byte: gdata
        - `uploadMetadataContainer` string, byte: gdata
      - `cosmoBinaryReference` string, byte: gdata
      - `crc32cHash` integer: gdata
      - `inline` string, byte: gdata
      - `length` string, int64: gdata
      - `md5Hash` string, byte: gdata
      - `objectId` GdataObjectId: gdata
        - `bucketName` string: gdata
        - `generation` string, int64: gdata
        - `objectName` string: gdata
      - `path` string: gdata
      - `referenceType` 'PATH' | 'BLOB_REF' | 'INLINE' | 'BIGSTORE_REF' | 'COSMO_BINARY_REFERENCE': gdata
      - `sha1Hash` string, byte: gdata
  - `diffUploadRequest` GdataDiffUploadRequest: gdata
    - `checksumsInfo` GdataCompositeMedia: gdata
      - `blobRef` string, byte: gdata
      - `blobstore2Info` GdataBlobstore2Info: gdata
        - `blobGeneration` string, int64: gdata
        - `blobId` string: gdata
        - `downloadExternalReadToken` string, byte: gdata
        - `downloadReadHandle` string, byte: gdata
        - `readToken` string: gdata
        - `uploadFragmentListCreationInfo` string, byte: gdata
        - `uploadMetadataContainer` string, byte: gdata
      - `cosmoBinaryReference` string, byte: gdata
      - `crc32cHash` integer: gdata
      - `inline` string, byte: gdata
      - `length` string, int64: gdata
      - `md5Hash` string, byte: gdata
      - `objectId` GdataObjectId: gdata
        - `bucketName` string: gdata
        - `generation` string, int64: gdata
        - `objectName` string: gdata
      - `path` string: gdata
      - `referenceType` 'PATH' | 'BLOB_REF' | 'INLINE' | 'BIGSTORE_REF' | 'COSMO_BINARY_REFERENCE': gdata
      - `sha1Hash` string, byte: gdata
    - `objectInfo` GdataCompositeMedia: gdata
      - `blobRef` string, byte: gdata
      - `blobstore2Info` GdataBlobstore2Info: gdata
        - `blobGeneration` string, int64: gdata
        - `blobId` string: gdata
        - `downloadExternalReadToken` string, byte: gdata
        - `downloadReadHandle` string, byte: gdata
        - `readToken` string: gdata
        - `uploadFragmentListCreationInfo` string, byte: gdata
        - `uploadMetadataContainer` string, byte: gdata
      - `cosmoBinaryReference` string, byte: gdata
      - `crc32cHash` integer: gdata
      - `inline` string, byte: gdata
      - `length` string, int64: gdata
      - `md5Hash` string, byte: gdata
      - `objectId` GdataObjectId: gdata
        - `bucketName` string: gdata
        - `generation` string, int64: gdata
        - `objectName` string: gdata
      - `path` string: gdata
      - `referenceType` 'PATH' | 'BLOB_REF' | 'INLINE' | 'BIGSTORE_REF' | 'COSMO_BINARY_REFERENCE': gdata
      - `sha1Hash` string, byte: gdata
    - `objectVersion` string: gdata
  - `diffUploadResponse` GdataDiffUploadResponse: gdata
    - `objectVersion` string: gdata
    - `originalObject` GdataCompositeMedia: gdata
      - `blobRef` string, byte: gdata
      - `blobstore2Info` GdataBlobstore2Info: gdata
        - `blobGeneration` string, int64: gdata
        - `blobId` string: gdata
        - `downloadExternalReadToken` string, byte: gdata
        - `downloadReadHandle` string, byte: gdata
        - `readToken` string: gdata
        - `uploadFragmentListCreationInfo` string, byte: gdata
        - `uploadMetadataContainer` string, byte: gdata
      - `cosmoBinaryReference` string, byte: gdata
      - `crc32cHash` integer: gdata
      - `inline` string, byte: gdata
      - `length` string, int64: gdata
      - `md5Hash` string, byte: gdata
      - `objectId` GdataObjectId: gdata
        - `bucketName` string: gdata
        - `generation` string, int64: gdata
        - `objectName` string: gdata
      - `path` string: gdata
      - `referenceType` 'PATH' | 'BLOB_REF' | 'INLINE' | 'BIGSTORE_REF' | 'COSMO_BINARY_REFERENCE': gdata
      - `sha1Hash` string, byte: gdata
  - `diffVersionResponse` GdataDiffVersionResponse: gdata
    - `objectSizeBytes` string, int64: gdata
    - `objectVersion` string: gdata
  - `downloadParameters` GdataDownloadParameters: gdata
    - `allowGzipCompression` boolean: gdata
    - `ignoreRange` boolean: gdata
  - `filename` string: gdata
  - `hash` string: gdata
  - `hashVerified` boolean: gdata
  - `inline` string, byte: gdata
  - `isPotentialRetry` boolean: gdata
  - `length` string, int64: gdata
  - `md5Hash` string, byte: gdata
  - `mediaId` string, byte: gdata
  - `objectId` GdataObjectId: gdata
    - `bucketName` string: gdata
    - `generation` string, int64: gdata
    - `objectName` string: gdata
  - `path` string: gdata
  - `referenceType` 'PATH' | 'BLOB_REF' | 'INLINE' | 'GET_MEDIA' | 'COMPOSITE_MEDIA' | 'BIGSTORE_REF' | 'DIFF_VERSION_RESPONSE' | 'DIFF_CHECKSUMS_RESPONSE' | 'DIFF_DOWNLOAD_RESPONSE' | 'DIFF_UPLOAD_REQUEST' | 'DIFF_UPLOAD_RESPONSE' | 'COSMO_BINARY_REFERENCE' | 'ARBITRARY_BYTES': gdata
  - `sha1Hash` string, byte: gdata
  - `sha256Hash` string, byte: gdata
  - `sha512Hash` string, byte: gdata
  - `timestamp` string, uint64: gdata
  - `token` string: gdata

---

[API](https://skmtc.dev/google/apis/youtubereporting.md) - [All operations](https://skmtc.dev/google/apis/youtubereporting/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/youtubereporting/revisions/88074b6984ff?raw)
