Google Drive API, iki düzeyde hata bilgisi döndürür:
- HTTP hata kodları ve üstbilgi mesajları.
- Yanıt gövdesinde, hatanın nasıl ele alınacağını belirlemenize yardımcı olabilecek ek ayrıntılar içeren bir JSON nesnesi.
Google Drive uygulamaları, REST API kullanılırken karşılaşılabilecek tüm hataları yakalamalı ve işlemelidir. Bu kılavuzda, belirli Drive API hatalarının nasıl çözüleceğiyle ilgili talimatlar verilmektedir.
HTTP durum kodu özeti
Hata kodu | Açıklama |
---|---|
200 - OK |
İstek başarılıdır (Bu, başarılı HTTP istekleri için standart yanıttır). |
400 - Bad Request |
İstekteki istemci hatası nedeniyle istek yerine getirilemiyor. |
401 - Unauthorized |
İstek geçersiz kimlik bilgileri içeriyor. |
403 - Forbidden |
İstek alındı ve anlaşıldı ancak kullanıcının isteği gerçekleştirme izni yok. |
404 - Not Found |
İstenen sayfa bulunamadı. |
429 - Too Many Requests |
API'ye çok fazla istek gönderildi. |
500, 502, 503, 504 - Server Errors |
İstek işlenirken beklenmeyen bir hata oluşur. |
400 hataları
Bu hatalar, isteğin kabul edilemez olduğu anlamına gelir. Bunun nedeni genellikle gerekli bir parametrenin eksik olmasıdır.
badRequest
Bu hata, kodunuzdaki aşağıdaki sorunlardan herhangi biri nedeniyle oluşabilir:
- Zorunlu bir alan veya parametre sağlanmadı.
- Sağlanan değer veya sağlanan alanların bir kombinasyonu geçersiz.
- Bir Drive dosyasına yinelenen bir üst öğe eklemeye çalıştınız.
- Dizin grafiğinde döngü oluşturacak bir üst öğe eklemeye çalıştınız.
Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"code": 400,
"errors": [
{
"domain": "global",
"location": "orderBy",
"locationType": "parameter",
"message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order.",
"reason": "badRequest"
}
],
"message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order."
}
}
Bu hatayı düzeltmek için message
alanını kontrol edin ve kodunuzu buna göre ayarlayın.
illegalKeepForeverModification
Bu hata, "Keep
Forever" olarak işaretlenmiş bir blob dosyası revizyonunu false
olarak ayarlamaya çalışırken oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "illegalKeepForeverModification",
"message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
}
],
"code": 400,
"message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
}
}
Bu hatayı düzeltmek için "Sonsuza Kadar Sakla" ayarını kaldırmak üzere bir blob dosyası düzeltmesini kalıcı olarak silin.
invalidSharingRequest
Bu hata çeşitli nedenlerden kaynaklanır. Nedeni belirlemek için döndürülen JSON'daki reason
alanını değerlendirin. Bu hata en sık şu nedenlerle oluşur:
- Paylaşım başarılı oldu ancak bildirim e-postası doğru şekilde teslim edilmedi.
- Bu kullanıcı için erişim kontrol listesi (EKL) değişikliğine izin verilmiyor.
message
alanı, gerçek hatayı gösterir.
Paylaşım başarılı oldu ancak bildirim e-postası doğru şekilde teslim edilmedi
Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "invalidSharingRequest",
"message": "Bad Request. User message: \"Sorry, the items were successfully shared but emails could not be sent to email@domain.com.\""
}
],
"code": 400,
"message": "Bad Request"
}
}
Bu hatayı düzeltmek için kullanıcıya (paylaşan) bildirim e-postası hedef e-posta adresine gönderilemediğinden paylaşım yapamadığını bildirin. Kullanıcı, doğru e-posta adresine sahip olduğundan ve bu adresin e-posta alabildiğinden emin olmalıdır.
Bu kullanıcı için ACL değişikliğine izin verilmiyor
Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "invalidSharingRequest",
"message": "Bad Request. User message: \"ACL change not allowed.\""
}
],
"code": 400,
"message": "Bad Request"
}
}
Bu hatayı düzeltmek için dosyanın ait olduğu Google Workspace alanının paylaşım ayarlarını kontrol edin. Ayarlar, alanın dışında paylaşımı yasaklıyor olabilir veya ortak drive paylaşımına izin verilmiyor olabilir.
401 hataları
Bu hatalar, isteğin geçerli bir erişim jetonu içermediği anlamına gelir.
authError
Bu hata, kullandığınız erişim jetonunun süresi dolduğunda veya jeton geçersiz olduğunda ortaya çıkar. Bu hata, istenen kapsamlar için yetkilendirmenin eksik olmasından da kaynaklanabilir. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "authError",
"message": "Invalid Credentials",
"locationType": "header",
"location": "Authorization",
}
],
"code": 401,
"message": "Invalid Credentials"
}
}
Bu hatayı düzeltmek için uzun süreli yenileme jetonunu kullanarak erişim jetonunu yenileyin. Bu işlem başarısız olursa kullanıcıyı Google Drive API kapsamlarını seçme bölümünde açıklandığı gibi OAuth akışına yönlendirin.
fileNotDownloadable
Bu hata, Google Workspace dokümanında revisions.get
yöntemini alt=media
URL parametresiyle kullanmaya çalıştığınızda oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "fileNotDownloadable",
"message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
}
],
"code": 403,
"message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
}
}
Bu hatayı düzeltmek için aşağıdakilerden herhangi birini deneyin:
- Belirli bir düzeltmenin meta verilerini (ör. MIME türü) görüntülemek istiyorsanız
alt=media
URL parametresini kaldırın. - Google Workspace dokümanı bayt içeriklerini dışa aktarmak için
files.export
yöntemini kullanın. Daha fazla bilgi için Google Workspace belge içeriğini dışa aktarma başlıklı makaleyi inceleyin.
403 hataları
Bu hatalar, kullanım sınırının aşıldığı veya kullanıcının doğru ayrıcalıklara sahip olmadığı anlamına gelir. Nedeni belirlemek için döndürülen JSON'un reason
alanını değerlendirin.
Drive API sınırları hakkında bilgi için Kullanım sınırları başlıklı makaleyi inceleyin. Drive klasör sınırları hakkında bilgi için Dosya ve klasör sınırları başlıklı makaleyi inceleyin.
activeItemCreationLimitExceeded
Hesap başına oluşturulan öğe sayısı sınırı aşıldığında activeItemCreationLimitExceeded
hatası oluşur. Her kullanıcı, bir hesap tarafından oluşturulmuş 500 milyon öğeye sahip olabilir. Daha fazla bilgi için Kullanıcı öğesi sınırı başlıklı makaleyi inceleyin.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "activeItemCreationLimitExceeded",
"message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
}
],
"code": 403,
"message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
}
}
Bu hatayı düzeltmek için:
Kullanıcıya, Drive'ın hesapların 500 milyon öğeden fazla oluşturmasını engellediğini bildirin.
Kullanıcının bu aynı hesapta öğe oluşturması gerekiyorsa bazı nesneleri kalıcı olarak silmesini isteyin. Aksi takdirde, şartı karşılayan farklı bir hesap kullanabilirler.
appNotAuthorizedToFile
Bu hata, uygulamanız dosyanın ACL'sinde olmadığında oluşur. Bu hata, kullanıcının dosyayı uygulamanızla açmasını engeller. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "appNotAuthorizedToFile",
"message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
}
],
"code": 403,
"message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
}
}
Bu hatayı düzeltmek için aşağıdakilerden herhangi birini deneyin:
- Google Drive seçiciyi açın ve kullanıcıdan dosyayı açmasını isteyin.
- Kullanıcıya, uygulamanızın Drive kullanıcı arayüzündeki Birlikte aç içerik menüsünü kullanarak dosyayı açmasını söyleyin.
- Uygulamanızın dosyayı oluşturduğunu veya açtığını doğrulamak için
files
kaynağındakifiles.get
yöntemini kullanarakisAppAuthorized
alanını kontrol edin.
cannotModifyInheritedTeamDrivePermission
Bu hata, bir kullanıcı ortak Drive'daki bir öğenin devralınan izinlerini değiştirmeye çalıştığında oluşur. Devralınan izinler, ortak Drive'daki bir öğeden kaldırılamaz. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "cannotModifyInheritedTeamDrivePermission",
"message": "Cannot update or delete an inherited permission on a shared drive item."
}
],
"code": 403,
"message": "Cannot update or delete an inherited permission on a shared drive item."
}
}
Bu hatayı düzeltmek için kullanıcının, doğrudan veya dolaylı üst öğede izinleri ayarlaması gerekir. Daha fazla bilgi için İzinlerin işleyiş şekli başlıklı makaleyi inceleyin. Bu ortak Drive öğesindeki izinlerin devralınmış mı yoksa doğrudan uygulanmış mı olduğunu görmek için permissions
kaynağını da alabilirsiniz.
dailyLimitExceeded
Bu hata, projenizin API sınırına ulaşıldığında meydana gelir. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "usageLimits",
"reason": "dailyLimitExceeded",
"message": "Daily Limit Exceeded"
}
],
"code": 403,
"message": "Daily Limit Exceeded"
}
}
Bu hata, uygulamanın sahibi belirli bir kaynağın kullanımını sınırlamak için kota sınırı belirlediğinde gösterilir. Bu hatayı düzeltmek için "Günlük sorgu sayısı" kotasıyla ilgili tüm kullanım sınırlarını kaldırın.
domainPolicy
Bu hata, kullanıcının alanıyla ilgili politika, uygulamanızın Drive'a erişmesine izin vermediğinde oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "domainPolicy",
"message": "The domain administrators have disabled Drive apps."
}
],
"code": 403,
"message": "The domain administrators have disabled Drive apps."
}
}
Bu hatayı düzeltmek için:
- Kullanıcıya, alanın uygulamanızın Drive'daki dosyalara erişmesine izin vermediğini bildirin.
- Kullanıcıya, uygulamanıza erişim isteğinde bulunmak için alan yöneticisiyle iletişime geçmesini söyleyin.
downloadRestrictedForRevision
Bu hata, kullanıcı bir blob dosyası düzeltmesini indiremediğinde oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "download_restricted_for_revision",
"message": "This revision cannot be downloaded by the authenticated user."
}
],
"code": 403,
"message": "This revision cannot be downloaded by the authenticated user."
}
}
Bu hatayı düzeltmek için kullanıcıya, blob dosyası revizyonlarının yalnızca "Sonsuza Kadar Sakla" olarak işaretlenmesi durumunda indirilebileceğini bildirin. Daha fazla bilgi için Otomatik silme işleminden kurtarmak üzere kaydedilecek revizyonları belirtme başlıklı makaleyi inceleyin.
fileOwnerNotMemberOfTeamDrive
Bu hata, bir dosyayı ortak drive'a taşımaya çalışırken dosyanın sahibi üye olmadığında oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "fileOwnerNotMemberOfTeamDrive",
"message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
}
],
"code": 403,
"message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
}
}
Bu hatayı düzeltmek için:
Üyeyi
role=owner
ile ortak drive'a ekleyin. Daha fazla bilgi için Dosya, klasör ve sürücü paylaşma başlıklı makaleyi inceleyin.Dosyayı ortak drive'a ekleyin. Daha fazla bilgi için Klasör oluşturma ve klasörlere içerik ekleme başlıklı makaleyi inceleyin.
fileWriterTeamDriveMoveInDisabled
Bu hata, bir alan yöneticisi role=writer
alanına sahip kullanıcıların öğeleri ortak Drive'a taşımasına izin vermediğinde oluşur. Öğeleri taşımaya çalışan kullanıcının, hedef ortak Drive'da izin verilenlerden daha az izni var. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "fileWriterTeamDriveMoveInDisabled",
"message": "The domain administrator has not allowed writers to move items into a shared drive."
}
],
"code": 403,
"message": "The domain administrator has not allowed writers to move items into a shared drive."
}
}
Bu hatayı düzeltmek için hem kaynak hem de hedef ortak sürücülerde aynı yönetici kullanıcı hesabını kullanın.
insufficientFilePermissions
Bu hata, kullanıcının bir dosyaya yazma erişimi olmadığında ve uygulamanız dosyayı değiştirmeye çalıştığında oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "insufficientFilePermissions",
"message": "The user does not have sufficient permissions for file {fileId}."
}
],
"code": 403,
"message": "The user does not have sufficient permissions for file {fileId}."
}
}
Bu hatayı düzeltmek için kullanıcıya dosyanın sahibiyle iletişime geçip düzenleme erişimi istemesini söyleyin. Ayrıca, files.get
yöntemiyle alınan meta verilerdeki kullanıcı erişim düzeylerini kontrol edebilir ve izinler eksik olduğunda salt okunur bir kullanıcı arayüzü görüntüleyebilirsiniz.
myDriveHierarchyDepthLimitExceeded
İç içe yerleştirilmiş klasör düzeylerinin sayısı sınırı aşıldığında myDriveHierarchyDepthLimitExceeded
hatası oluşur. Bir kullanıcının Drive'ım bölümünde en fazla 100 düzeyde iç içe yerleştirilmiş klasör olabilir. Daha fazla bilgi için Klasör derinliği sınırı başlıklı makaleyi inceleyin.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "myDriveHierarchyDepthLimitExceeded",
"message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/workspace/drive/api/guides/handle-errors#nested-folder-levels."
}
],
"code": 403,
"message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/workspace/drive/api/guides/handle-errors#nested-folder-levels."
}
}
Bu hatayı düzeltmek için:
- Drive'ın klasörlerin 100'den fazla düzeyde yerleştirilmesini engellediğini kullanıcıya bildirin.
- Kullanıcının başka bir iç içe klasör oluşturması gerekiyorsa üst klasörü 100'den az düzeyde olacak şekilde yeniden düzenlemesini veya bu koşulu karşılayan farklı bir üst klasör kullanmasını isteyin.
numChildrenInNonRootLimitExceeded
Bu hata, bir klasörün alt öğe sayısı (klasörler, dosyalar ve kısayollar) sınırı aşıldığında oluşur. Doğrudan bir klasörde bulunan klasörler, dosyalar ve kısayollar için 500.000 öğe sınırı vardır. Alt klasörlerdeki öğeler bu 500.000 öğe sınırına dahil edilmez. Drive klasör sınırları hakkında daha fazla bilgi için Google Drive'daki klasör sınırları başlıklı makaleyi inceleyin.
Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "numChildrenInNonRootLimitExceeded",
"message": "The limit for this folder's number of children (files and folders) has been exceeded."
}
],
"code": 403,
"message": "The limit for this folder's number of children (files and folders) has been exceeded."
}
}
Bu hatayı düzeltmek için aşağıdakilerden herhangi birini deneyin:
- Kullanıcıyı,Drive'ın 500.000'den fazla öğe içeren klasörleri engellediği konusunda bilgilendirin.
- Kullanıcının tam klasöre daha fazla öğe eklemesi gerekiyorsa klasörü 500.000'den az öğe içerecek şekilde yeniden düzenlemesini veya daha az öğe içeren benzer bir klasör kullanmasını isteyin.
rateLimitExceeded
Bu hata, projenin hız sınırına ulaşıldığında oluşur. Bu sınır, istek türüne göre değişir. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "usageLimits",
"message": "Rate Limit Exceeded",
"reason": "rateLimitExceeded",
}
],
"code": 403,
"message": "Rate Limit Exceeded"
}
}
Bu hatayı düzeltmek için aşağıdakilerden herhangi birini deneyin:
- Google Cloud projesinde kullanıcı başına kotayı artırın. Daha fazla bilgi için kota artışı isteğinde bulunun.
- Birden fazla API çağrısını tek bir HTTP isteğinde paketlemek için toplu istekler.
- İsteği yeniden denemek için eksponansiyel geri yükleme kullanın.
sharingRateLimitExceeded
Bu hata, kullanıcı bir paylaşım sınırına ulaştığında ortaya çıkar ve genellikle bir e-posta sınırı ile bağlantılıdır. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"message": "Rate limit exceeded. User message: \"These item(s) could not be shared because a rate limit was exceeded: filename",
"reason": "sharingRateLimitExceeded",
}
],
"code": 403,
"message": "Rate Limit Exceeded"
}
}
Bu hatayı düzeltmek için:
- Çok sayıda dosya paylaşırken e-posta göndermeyin.
- Bir kullanıcı, Google Workspace hesabının birçok kullanıcısı adına çok sayıda istekte bulunuyorsa
quotaUser
parametresini kullanarak alan genelinde temsil yetkisi olan bir hizmet hesabı kullanmayı düşünebilirsiniz.
storageQuotaExceeded
Bu hata, kullanıcı depolama alanı sınırına ulaştığında oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"message": "The user's Drive storage quota has been exceeded.",
"reason": "storageQuotaExceeded",
}
],
"code": 403,
"message": "The user's Drive storage quota has been exceeded."
}
}
Bu hatayı düzeltmek için:
Drive hesabınızın depolama alanı sınırlarını inceleyin. Daha fazla bilgi için Google Workspace depolama alanı ve yükleme sınırları başlıklı makaleyi inceleyin.
Drive, Gmail ve Google Fotoğraflar'da depolama alanınızı yönetin.
teamDriveFileLimitExceeded
Bu hata, bir kullanıcı paylaşılan sürücüdeki katı öğe sınırını aşmaya çalıştığında oluşur. Bir kullanıcının ortak Drive'ındaki her klasör için dosyalar, klasörler ve kısayollar dahil olmak üzere 500.000 öğe sınırı vardır. Bu sınır, depolama alanı kullanımına değil, öğe sayısına bağlıdır. Daha fazla bilgi için Google Drive'da ortak Drive sınırları başlıklı makaleyi inceleyin.
Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "teamDriveFileLimitExceeded",
"message": "The file limit for this shared drive has been exceeded."
}
],
"code": 403,
"message": "The file limit for this shared drive has been exceeded."
}
}
Bu hatayı düzeltmek için ortak drive'daki öğe sayısını azaltın. Çok fazla dosya bulunan ortak drive'ların düzenlenmesi ve bu drive'lar içinde arama yapılması zor olabilir.
teamDriveHierarchyTooDeep
Paylaşılan Drive'daki iç içe yerleştirilmiş klasör düzeylerinin sayısı sınırı aşıldığında teamDriveHierarchyTooDeep
hatası oluşur. Bir kullanıcının ortak drive'ında 100'den fazla iç içe yerleştirilmiş klasör düzeyi olamaz. Daha fazla bilgi için Klasör derinliği sınırı başlıklı makaleyi inceleyin.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "teamDriveHierarchyTooDeep",
"message": "The shared drive hierarchy depth will exceed the limit."
}
],
"code": 403,
"message": "The shared drive hierarchy depth will exceed the limit."
}
}
Bu hatayı düzeltmek için:
- Kullanıcıya, ortak Drive'larda klasörlerin 100 düzeyden daha derine yerleştirilemediğini bildirin.
- Kullanıcının başka bir iç içe klasör oluşturması gerekiyorsa üst klasörü 100'den az düzeyde olacak şekilde yeniden düzenlemesini veya bu koşulu karşılayan farklı bir üst klasör kullanmasını isteyin.
teamDriveMembershipRequired
Bu hata, kullanıcının üyesi olmadığı bir ortak Drive'a erişmeye çalıştığında oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "teamDriveMembershipRequired",
"message": "The attempted action requires shared drive membership."
}
],
"code": 403,
"message": "The attempted action requires shared drive membership."
}
}
Bu hatayı düzeltmek için aşağıdakilerden herhangi birini deneyin:
Ortak Drive yöneticisinden, gerçekleştirmeniz gereken işlem için uygun izinlerle sizi eklemesini isteyin.
Paylaşılan sürücülere kimlerin erişebileceğini ve bunları kimlerin yönetebileceğini öğrenmek için Drive'ın rollerini ve izinlerini inceleyin. Erişim düzeyleri hakkında daha fazla bilgiyi Ortak Drive oluşturma başlıklı makalede bulabilirsiniz.
teamDrivesFolderMoveInNotSupported
Bu hata, bir kullanıcı Drive'ım klasöründeki bir klasörü ortak Drive'a taşımaya çalıştığında oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "teamDrivesFolderMoveInNotSupported",
"message": "Moving folders into shared drives is not supported."
}
],
"code": 403,
"message": "Moving folders into shared drives is not supported."
}
}
Bu hatayı düzeltmek için aşağıdakilerden herhangi birini deneyin:
Drive API'yi kullanarak klasördeki öğeleri tek tek ortak Drive'a taşıyın. Hem Drive'ım hem de ortak Drive'ların desteklendiğini belirtmek için
supportsAllDrives=true
parametresini ayarlayın.Klasörü ortak Drive'a taşımanız gerekiyorsa Drive kullanıcı arayüzünü kullanın. Daha fazla bilgi için Yönetici olarak klasörleri ortak Drive'lara taşıma başlıklı makaleyi inceleyin.
teamDrivesParentLimit
Bu hata, kullanıcı bir öğeye birden fazla üst öğe eklemeye çalıştığında oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "teamDrivesParentLimit",
"message": "A shared drive item must have exactly one parent."
}
],
"code": 403,
"message": "A shared drive item must have exactly one parent."
}
}
Bu hatayı düzeltmek için Drive kısayollarını kullanarak bir dosyaya birden fazla bağlantı ekleyin. Kısayolun yalnızca bir üst öğesi olabilir ancak kısayol dosyası ek konumlara kopyalanabilir. Daha fazla bilgi için Drive dosyasının kısayolunu oluşturma başlıklı makaleyi inceleyin.
UrlLeaseLimitExceeded
Bu hata, Google Play oyun verilerini uygulamanız üzerinden kaydetmeye çalışırken oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "usageLimits",
"reason": "UrlLeaseLimitExceeded",
"message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
}
],
"code": 403,
"message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
}
}
Bu hatayı düzeltmek için daha fazla anlık görüntü oluşturmadan önce anlık görüntü yüklemelerini tamamlayın veya iptal edin.
userRateLimitExceeded
Bu hata, kullanıcı başına sınıra ulaşıldığında oluşur. Bu durum, Google Cloud Console'daki veya Drive arka ucundaki bir sınırdan kaynaklanıyor olabilir. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "usageLimits",
"reason": "userRateLimitExceeded",
"message": "User Rate Limit Exceeded"
}
],
"code": 403,
"message": "User Rate Limit Exceeded"
}
}
Bu hatayı düzeltmek için aşağıdakilerden herhangi birini deneyin:
Google Cloud projesinde kullanıcı başına kotayı artırın. Daha fazla bilgi için kota artışı isteğinde bulunun.
Bir kullanıcı, Google Workspace hesabının birçok kullanıcısı adına çok sayıda istekte bulunuyorsa
quotaUser
parametresini kullanarak alan genelinde temsil yetkisi olan bir hizmet hesabı kullanmayı düşünebilirsiniz.İsteği yeniden denemek için eksponansiyel geri yükleme kullanın.
Drive API sınırları hakkında bilgi için Kullanım sınırları başlıklı makaleyi inceleyin.
404 hataları
Bu hatalar, istenen kaynağın erişilebilir olmadığı veya mevcut olmadığı anlamına gelir.
notFound
Bu hata, kullanıcının bir dosyaya okuma erişimi olmadığında veya dosya mevcut olmadığında oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "notFound",
"message": "File not found {fileId}"
}
],
"code": 404,
"message": "File not found: {fileId}"
}
}
Bu hatayı düzeltmek için:
- Dosya bir ortak drive'da bulunuyorsa ve
files.get
yöntemini kullanıyorsanızsupportsAllDrives
sorgu parametresinintrue
olarak ayarlandığından emin olun. - Kullanıcıya, dosyaya okuma erişiminin olmadığını veya dosyanın mevcut olmadığını bildirin.
- Kullanıcıdan dosyanın sahibiyle iletişime geçip dosyaya erişim izni istemesini isteyin.
429 hataları
Bu hatalar, API'ye çok hızlı bir şekilde çok fazla istek gönderildiği anlamına gelir.
rateLimitExceeded
Bu hata, kullanıcının belirli bir süre içinde çok fazla istek göndermesi durumunda oluşur. Aşağıdaki JSON örneği, bu hatanın bir gösterimidir:
{
"error": {
"errors": [
{
"domain": "usageLimits",
"reason": "rateLimitExceeded",
"message": "Rate Limit Exceeded"
}
],
"code": 429,
"message": "Rate Limit Exceeded"s
}
}
Bu hatayı düzeltmek için isteği yeniden denemek üzere eksponansiyel geri yüklemeyi kullanın.
500, 502, 503, 504 hataları
Bu hatalar, istek işlenirken beklenmeyen bir sunucu hatası oluştuğunda meydana gelir. İsteğin zamanlamasının başka bir istekle çakışması veya Google Siteler'de izinleri sitenin tamamı yerine tek bir sayfa için güncellemeye çalışmak gibi desteklenmeyen bir işlem isteği de dahil olmak üzere çeşitli sorunlar bu hatalara neden olabilir.
Aşağıda 5xx hatalarının listesi verilmiştir:
- 500 Arka uç hatası
- 502 Hatalı Ağ Geçidi
- 503 Hizmet Kullanılamıyor
- 504 Ağ Geçidi Zaman Aşımı
Bu hatayı düzeltmek için isteği yeniden denemek üzere eksponansiyel geri yüklemeyi kullanın.