Hataları çözme

Google Drive API'si iki düzeyde hata bilgisi döndürür:

• HTTP hata kodları ve başlık mesajları.
• Yanıt gövdesinde, hatanın nasıl işleneceğini 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ı yakalayıp işlemelidir. Bu kılavuzda, belirli Drive API hatalarının nasıl düzeltileceği hakkında talimatlar sunulmaktadır.

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 bir 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ştu.

400 hataları

Bu hatalar, genellikle gerekli bir parametrenin eksik olması nedeniyle isteğin kabul edilemez olduğu anlamına gelir.

badRequest

Bu hata, kodunuzda aşağıdaki sorunların herhangi birinden kaynaklanabilir:

• Zorunlu bir alan veya parametre sağlanmadı.
• Sağlanan değer veya sağlanan alanların bir kombinasyonu geçersiz.
• Bir Drive dosyasına kopya ü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 temsilidir:

{
  "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.

invalidSharingRequest

Bu hata çeşitli nedenlerle ortaya çıkar. Nedeni belirlemek için döndürülen JSON dosyasının reason alanını değerlendirin. Bu hata genellikle aşağıdaki nedenlerden kaynaklanır:

• 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şıldı, ancak bildirim e-postası doğru şekilde teslim edilmedi

Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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ıyı (paylaşan kişiye), bildirim e-postası hedef e-posta adresine gönderilemediği için paylaşamadığını bildirin. Kullanıcı, doğru e-posta adresine sahip olduğundan ve e-posta alabildiğinden emin olmalıdır.

Bu kullanıcı için EKL değişikliğine izin verilmiyor

Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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 dışında paylaşıma veya ortak Drive'a izin vermiyor 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 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 temsilidir:

{
  "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 ömürlü yenileme jetonunu kullanarak erişim jetonunu yenileyin. Bu başarısız olursa, Google Drive API kapsamlarını seçme bölümünde açıklandığı gibi kullanıcıyı OAuth akışı üzerinden yönlendirin.

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'ın reason alanını değerlendirin.

Drive API sınırları hakkında bilgi edinmek 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 milyona kadar öğeye sahip olabilir. Daha fazla bilgi için Kullanıcı öğesi sınırı bölümüne bakın.

{
 "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:

1. Kullanıcıya Drive'ın, hesapların 500 milyondan fazla öğe oluşturmasını engellediğini bildirin.

2. Kullanıcının aynı hesapta öğeler oluşturması gerekiyorsa bazı nesneleri kalıcı olarak silmesi için talimat verin. Aksi takdirde, şartı zaten karşılayan farklı bir hesap kullanabilirler.

appNotAuthorizedToFile

Bu hata, uygulamanız dosyanın EKL'sinde olmadığında ortaya çıkar. Bu hata, kullanıcının dosyayı uygulamanızla açmasını engeller. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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 birini deneyin:

• Google Drive seçiciyi açın ve kullanıcıdan dosyayı açmasını isteyin.
• Kullanıcıdan, uygulamanızın Drive kullanıcı arayüzündeki Birlikte aç içerik menüsünü kullanarak dosyayı açmasını isteyin.
• files.get yöntemini kullanarak files kaynağındaki isAppAuthorized alanını kontrol ederek uygulamanızın dosyayı oluşturduğunu veya açtığını doğrulayın.

cannotModifyInheritedTeamDrivePermission

Bu hata, kullanıcı ortak Drive'daki bir öğenin devralınan izinlerini değiştirmeye çalıştığında ortaya çıkar. Devralınan izinler, ortak Drive'daki bir öğeden kaldırılamaz. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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, devralındıkları doğrudan veya dolaylı üst öğedeki izinleri ayarlaması gerekir. Daha fazla bilgi için İzin yayılımı bölümünü inceleyin. Bu ortak Drive öğesindeki izinlerin devralınıp alınmadığını veya doğrudan uygulanıp uygulanmadığını görmek için permissions.permissionDetails kaynağını da alabilirsiniz.

dailyLimitExceeded

Bu hata, projenizin API sınırına ulaşıldığında ortaya çıkar. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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örünür. Bu hatayı düzeltmek için "Günlük sorgu sayısı" kotasının tüm kullanım sınırlarını kaldırın.

domainPolicy

Bu hata, kullanıcının alan adının politikası, uygulamanızın Drive'a erişmesine izin vermediğinde ortaya çıkar. Aşağıdaki JSON örneği, bu hatanın temsilidir:

{
  "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:

1. Kullanıcıya, söz konusu alanın, uygulamanızın Drive'daki dosyalara erişmesine izin vermediğini bildirin.
2. Kullanıcıdan alan adı yöneticisiyle iletişime geçerek uygulamanız için erişim istemesini isteyin.

fileOwnerNotMemberOfTeamDrive

Bu hata, bir dosya ortak Drive'a taşınmaya çalışıldığında ve dosya sahibi üye olmadığında ortaya çıkar. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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:

1. Üyeyi role=owner ile birlikte ortak Drive'a ekleyin. Daha fazla bilgi edinmek için Dosya, klasör ve sürücü paylaşma başlıklı makaleyi inceleyin.

2. Dosyayı ortak drive'a ekleyin. Daha fazla bilgi için Klasör oluşturma ve doldurma konusuna bakın.

fileWriterTeamDriveMoveInDisabled

Bu hata, alan yöneticisi role=writer kullanan kullanıcıların ortak Drive'a öğe taşımasına izin vermediğinde ortaya çıkar. Öğeleri taşımaya çalışan kullanıcı, hedef ortak Drive'da izin verilenden daha az izne sahip. Aşağıdaki JSON örneği, bu hatanın temsilidir:

{
  "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 Drive'larda aynı yönetici kullanıcı hesabını kullanın.

insufficientFilePermissions

Bu hata, kullanıcının bir dosyaya yazma erişimi yoksa ve uygulamanız dosyayı değiştirmeye çalışıyorsa ortaya çıkar. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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ıdan dosyanın sahibiyle iletişime geçmesini ve düzenleme erişimi istemesini isteyin. 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üzeyi sayısı sınırı aşıldığında myDriveHierarchyDepthLimitExceeded hatası oluşur. Bir kullanıcının Drive'ım klasörü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ı bölümüne bakın.

{
 "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/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/drive/api/guides/handle-errors#nested-folder-levels."
 }
}

Bu hatayı düzeltmek için:

1. Kullanıcıya, Drive'ın 100 düzeyden daha derine klasörler yerleştirilmesini engellediğini bildirin.
2. Kullanıcının iç içe yerleştirilmiş başka bir klasör oluşturması gerekiyorsa kullanıcıdan hedeflenen üst klasörü 100 düzeyden daha az olacak şekilde yeniden düzenlemesi veya şartı zaten karşılayan farklı bir üst klasör kullanması talimatını verin.

numChildrenInNonRootLimitExceeded

Bu hata, bir klasörün alt öğe sayısı (klasörler, dosyalar ve kısayollar) sınırı aşıldığında ortaya çıkar. Doğrudan bir klasördeki klasörler, dosyalar ve kısayollar için 500.000 öğe sınırı vardır. Alt klasörlerde iç içe yerleştirilmiş öğ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'da klasör sınırları başlıklı makaleyi inceleyin.

Aşağıdaki JSON örneği bu hatanın temsilidir:

{
 "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 birini deneyin:

• Kullanıcıya Drive'ın 500.000'den fazla öğe içeren klasörleri engellediğini bildirin.
• 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 ya da daha az öğe içeren benzer bir klasör kullanmasını isteyin.

rateLimitExceeded

Bu hata, projenin oran sınırına ulaşıldığında ortaya çıkar. Bu sınır, isteğin türüne göre değişir. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
 "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 birini deneyin:

• Google Cloud projesinde kullanıcı başına kotayı artırın. Daha fazla bilgi için kota artışı isteyin.
• Daha az API çağrısı yapmak için toplu istekler.
• İsteği yeniden denemek için eksponansiyel geri yükleme işlevini kullanın.

sharingRateLimitExceeded

Bu hata, kullanıcı bir paylaşım sınırına ulaştığında ve genellikle bir e-posta sınırıyla bağlantılı olduğunda ortaya çıkar. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
 "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:

1. Büyük miktarda dosya paylaşırken e-posta göndermeyin.
2. Bir kullanıcı bir Google Workspace hesabının çok sayıda kullanıcısı adına çok sayıda istek gönderiyorsa quotaUser parametresini kullanarak alan genelinde yetkiye sahip bir hizmet hesabı kullanabilirsiniz.

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 temsilidir:

{
 "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:

1. Drive hesabınızın depolama alanı sınırlarını inceleyin. Daha fazla bilgi edinmek için Google Workspace depolama alanı ve yükleme sınırları başlıklı makaleyi inceleyin.

2. Google Drive depolama alanınızdaki dosyaları yönetin.

3. Daha fazla Google depolama alanı satın alın.

teamDriveFileLimitExceeded

Bu hata, bir kullanıcı ortak Drive'daki 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 temsilidir:

{
  "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 içeren ortak drive'ları düzenlemek ve aramak zor olabilir.

teamDriveHierarchyTooDeep

Ortak Drive'da iç içe yerleştirilmiş klasör düzeyi 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ı bölümüne bakın.

{
 "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:

1. Kullanıcıyı, ortak Drive'ların 100 düzeyden daha derine klasörler yerleştirilmesini engellediğini bildirin.
2. Kullanıcının iç içe yerleştirilmiş başka bir klasör oluşturması gerekiyorsa kullanıcıdan hedeflenen üst klasörü 100 düzeyden daha az olacak şekilde yeniden düzenlemesi veya şartı zaten karşılayan farklı bir üst klasör kullanması talimatını verin.

teamDriveMembershipRequired

Bu hata, bir kullanıcı üyesi olmadığı bir ortak Drive'a erişmeye çalıştığında oluşur. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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 birini deneyin:

1. Ortak Drive'ın yöneticisinden, gerçekleştirmeniz gereken işlem için sizi uygun izinleri eklemesini isteyin.

2. Ortak Drive'lara kimlerin erişebileceğini ve bunları kimlerin yönetebileceğini öğrenmek için Drive'ın Roller ve İzinleri bölümünü inceleyin. Erişim düzeyleri hakkında ek bilgileri Ortak drive oluşturma bölümünde de bulabilirsiniz.

teamDrivesFolderMoveInNotSupported

Bu hata, kullanıcı Drive'ım bölümündeki bir klasörü ortak drive'a taşımaya çalıştığında oluşur. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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 birini deneyin:

• Drive API'yi kullanarak klasördeki öğeleri tek tek bir ortak drive'a taşıyın. supportsAllDrives=true parametresini, hem Drive'ım hem de ortak Drive'lar desteğini gösterecek şekilde ayarlayın.

• Klasörü bir ortak Drive'a taşımanız gerekiyorsa Drive kullanıcı arayüzünü kullanın. Daha fazla bilgi edinmek için Yönetici olarak klasörleri ortak drive'lara taşıma başlıklı makaleyi inceleyin.

teamDrivesParentLimit

Bu hata, kullanıcı ortak Drive'daki bir öğeye birden fazla üst öğe eklemeye çalıştığında oluşur. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "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ı ekleyebilirsiniz. Kısayolun yalnızca bir üst öğesi olabilse de kısayol dosyası ek konumlara kopyalanabilir. Daha fazla bilgi edinmek için Drive dosyası için kısayol oluşturma başlıklı makaleyi inceleyin.

UrlLeaseLimitExceeded

Bu hata, Google Play oyun verilerini uygulamanız üzerinden kaydetmeye çalışırken ortaya çıkar. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
 "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 tüm yükleme işlemlerini tamamlayın veya iptal edin.

userRateLimitExceeded

Bu hata, kullanıcı başına sınıra ulaşıldığında ortaya çıkar. Bu, Google Cloud konsolundan veya Drive arka ucundan gelen bir sınır olabilir. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
 "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 birini deneyin:

• Google Cloud projesinde kullanıcı başına kotayı artırın. Daha fazla bilgi için kota artışı isteyin.

• Bir kullanıcı bir Google Workspace hesabının çok sayıda kullanıcısı adına çok sayıda istek gönderiyorsa quotaUser parametresini kullanarak alan genelinde yetkiye sahip bir hizmet hesabı kullanabilirsiniz.

• İsteği yeniden denemek için eksponansiyel geri yükleme işlevini kullanın.

Drive API sınırları hakkında bilgi edinmek 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 dosya için okuma erişimi olmadığında veya dosya mevcut olmadığında ortaya çıkar. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "File not found {fileId}"
      }
    ],
    "code": 404,
    "message": "File not found: {fileId}"
  }
}

Bu hatayı düzeltmek için:

1. Dosya ortak Drive'da bulunuyorsa ve files.get yöntemini kullanıyorsanız supportsAllDrives sorgu parametresinin true olarak ayarlandığından emin olun.
2. Kullanıcıya, dosya için okuma erişimi olmadığını veya dosyanın mevcut olmadığını bildirin.
3. Kullanıcıdan dosyanın sahibiyle iletişime geçmesini ve dosya için izin istemesini isteyin.

429 hataları

Bu hatalar, API'ye çok hızlı bir şekilde çok fazla isteğin gönderildiği anlamına gelir.

rateLimitExceeded

Bu hata, kullanıcı belirli bir süre içinde çok fazla istek gönderdiğinde ortaya çıkar. Aşağıdaki JSON örneği bu hatanın temsilidir:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "rateLimitExceeded",
        "message": "Rate Limit Exceeded"
      }
    ],
    "code": 429,
    "message": "Rate Limit Exceeded"s
  }
}

Bu hatayı düzeltmek için üstel geri yükleme yöntemini kullanarak isteği yeniden deneyin.

500, 502, 503, 504 hataları

Bu hatalar, istek işlenirken beklenmeyen bir sunucu hatası ortaya çıktığında ortaya çıkar. Bu hatalar, bir isteğin zamanlamasının başka bir istekle çakışması veya desteklenmeyen bir işlem isteğinin (ör. tüm site yerine Google Sites'ta tek bir sayfa için izinleri güncellemeye çalışılması) dahil olmak üzere çeşitli sorunlara yol açabilir.

Aşağıda, 5xx hatalarının bir 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 üstel geri yükleme yöntemini kullanarak isteği yeniden deneyin.

İlgili konular

• Performansı artırma
• Kimlik doğrulama ve yetkilendirme sorunlarını giderme