Method: files.get
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir dosyanın meta verilerini veya içeriğini kimliğe göre alır. Daha fazla bilgi için Dosya ve klasör arama başlıklı makaleyi inceleyin.
alt=media URL parametresini sağlarsanız yanıt, dosya içeriğini yanıt gövdesinde içerir. alt=media ile içerik indirme yalnızca dosya Drive'da depolanıyorsa çalışır. Google Dokümanlar, E-Tablolar ve Slaytlar'ı indirmek için files.export simgesini kullanın. Daha fazla bilgi için Dosyaları indirme ve dışa aktarma başlıklı makaleyi inceleyin.
HTTP isteği
GET https://www.googleapis.com/drive/v3/files/{fileId}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
fileId |
string
Dosyanın kimliği.
|
Sorgu parametreleri
| Parametreler |
acknowledgeAbuse |
boolean
Kullanıcının, bilinen kötü amaçlı yazılımları veya diğer kötüye kullanım amaçlı dosyaları indirme riskini kabul edip etmediği Bu durum yalnızca alt parametresi media olarak ayarlandığında ve kullanıcının dosyanın sahibi ya da dosyanın bulunduğu ortak Drive'ın düzenleyicisi olması durumunda geçerlidir.
|
supportsAllDrives |
boolean
İstek gönderen uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği
|
supportsTeamDrives
(deprecated) |
boolean
Desteği sonlandırıldı: Bunun yerine supportsAllDrives politikasını kullanın.
|
includePermissionsForView |
string
Yanıtın hangi ek görünüm izinlerini içereceğini belirtir. Yalnızca published desteklenir.
|
includeLabels |
string
Yanıtın labelInfo bölümüne dahil edilecek etiketlerin kimliklerinin virgülle ayrılmış listesi.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, File öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
Bazı kapsamlar kısıtlanmıştır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-27 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-27 UTC."],[],[],null,["# Method: files.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n\u003cbr /\u003e\n\nGets a file's metadata or content by ID.\n\nIf you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use [`files.export`](/workspace/drive/api/reference/rest/v3/files/export) instead. For more information, see [Download \\& export files](/workspace/drive/api/guides/manage-downloads).\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/files/{fileId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------|\n| `fileId` | `string` The ID of the file. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `acknowledgeAbuse` | `boolean` Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only 'published' is supported. |\n| `includeLabels` | `string` A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [File](/workspace/drive/api/reference/rest/v3/files#File).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
