Bu sayfa, Cloud Translation API ile çevrilmiştir.

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ı yakalamalı ve işlemelidir. Bu kılavuzda, belirli Drive API hatalarının nasıl çözüleceğine ilişkin talimatlar sağlanmaktadır.

HTTP durum kodu özeti

Hata kodu	Açıklama
`200 - OK`	İstek başarılı (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ştirmek için 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 yer alan aşağıdaki sorunların herhangi birinden kaynaklanabilir:

Zorunlu bir alan veya parametre sağlanmamış.
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 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 hatanın oluşmasının birkaç nedeni vardır. Nedeni belirlemek için döndürülen JSON dosyasının reason alanını değerlendirin. Bu hata en çok aşağıdaki nedenlerden kaynaklanır:

Paylaşım başarılı oldu, ancak bildirim e-postası doğru bir ş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 bir ş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) hedef e-posta adresine gönderemediği için bildirim e-postası gönderemediğini 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şımı yasaklayabilir veya ortak drive'ın paylaşılması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 dolmuş veya geçersiz olduğunda ortaya çıkar. Bu hata, istenen kapsamlar için eksik yetkilendirmeden de 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 süreli yenileme jetonunu kullanarak erişim jetonunu yenileyin. Bu başarısız olursa kullanıcıyı, Google Drive API kapsamlarını seçme bölümünde açıklandığı gibi OAuth akışı boyunca 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 öğesinin reason alanını değerlendirin.

Drive API sınırları hakkında bilgi edinmek için Kullanım sınırları başlıklı makaleye göz atın. Drive klasör sınırları hakkında bilgi edinmek için Dosya ve klasör sınırları başlıklı makaleye bakın.

`activeItemCreationLimitExceeded`

Hesap başına oluşturulan öğe sayısı sınırı aşıldığında activeItemCreationLimitExceeded hatası oluşur. Bir kullanıcı, bir hesap tarafından oluşturulmuş en fazla 500 milyon öğ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:

Kullanıcıya Drive'ın, hesapların 500 milyondan fazla öğe oluşturmasını engellediğini bildirin.
Kullanıcının aynı hesapta öğeler oluşturması gerekiyorsa bazı nesneleri kalıcı olarak silmesini söyleyin. Aksi takdirde, koşulu halihazırda 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, bir 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ığı doğrudan veya dolaylı üst öğenin izinlerini ayarlaması gerekir. Daha fazla bilgi için İzin dağıtımı bölümüne bakın. 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 oluşur. Aşağıdaki JSON örneği bu hatayı temsil etmektedir:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "dailyLimitExceeded",
        "message": "Daily Limit Exceeded"
      }
    ],
    "code": 403,
    "message": "Daily Limit Exceeded"
  }
}

Uygulamanın sahibi, belirli bir kaynağın kullanımını sınırlamak için kota sınırı belirlediğinde bu hata gösterilir. Bu hatayı düzeltmek için "Günlük sorgu sayısı" kotası için tüm kullanım sınırlarını kaldırın.

`domainPolicy`

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

{
  "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ıyı alan adının, uygulamanızın Drive'daki dosyalara erişmesine izin vermediğini bildirin.
Kullanıcıdan, uygulamanıza erişim istemek için alan yöneticisiyle iletişime geçmesini isteyin.

`fileOwnerNotMemberOfTeamDrive`

Bu hata, ortak Drive'a dosya taşımaya çalışıldığında ve dosya sahibi üye değilse 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:

Ü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ı makaleye göz atın.
Dosyayı ortak Drive'a ekleyin. Daha fazla bilgi için Klasör oluşturma ve doldurma bölümüne bakın.

`fileWriterTeamDriveMoveInDisabled`

Bu hata, bir alan yöneticisi role=writer adresine sahip kullanıcıların bir ortak Drive'a öğe taşımasına izin vermediğinde ortaya çıkar. Öğeleri taşımaya çalışan kullanıcının, hedef ortak Drive'da izin verilenden daha az izni var. 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'da 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 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ıya dosyanın sahibiyle iletişime geçmesini ve düzenleme erişimi istemesini söyleyin. Ayrıca, files.get yöntemi tarafından alınan meta verilerdeki kullanıcı erişim düzeylerini kontrol edebilir ve izinler eksik olduğunda salt okunur 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 bölümünde en fazla 100 düzeyde iç içe yerleştirilmiş klasör bulunabilir. Daha fazla bilgi edinmek için Klasör derinliği sınırı sayfasını 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/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:

Drive'ın, klasörlerin 100 seviyeden fazla derine yerleştirilmesini engellediğini kullanıcıya bildirin.
Kullanıcının başka bir iç içe geçmiş klasör oluşturması gerekiyorsa istenen üst klasörü 100'den az düzey derinde olacak şekilde yeniden düzenlemesini veya gereksinimi hâlihazırda 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) için belirlenen sınır aşıldığında ortaya çıkar. Doğrudan bir klasör içinde bulunan 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 edinmek için Google Drive'da klasör sınırları başlıklı makaleye bakın.

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 veya zaten 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 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 projesindeki kullanıcı başına kotayı artırın. Daha fazla bilgi için kota artışı isteğinde bulunun.
Daha az API çağrısı yapmak için toplu istekler.
İsteği yeniden denemek için eksponansiyel geri yükleme'yi 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:

Büyük miktarda dosya paylaşırken e-posta göndermeyin.
Bir kullanıcı, bir Google Workspace hesabının birçok kullanıcısı adına çok sayıda istek yapıyorsa quotaUser parametresini kullanarak alan genelinde yetki verilmiş 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 hatayı temsil etmektedir:

{
 "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 edinmek için Google Workspace depolama alanı ve yükleme sınırları başlıklı makaleyi inceleyin.
Google Drive depolama alanınızdaki dosyaları yönetin.
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 ortaya çıkar. Bir kullanıcının ortak Drive'ındaki her klasörde, dosyalar, klasörler ve kısayollar dahil olmak üzere 400.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 edinmek için, Google Drive'da ortak Drive sınırları başlıklı makaleye göz atın.

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ın düzenlenmesi ve aranması zor olabilir.

`teamDriveMembershipRequired`

Bu hata, bir kullanıcı üyesi olmadığı bir ortak Drive'a erişmeye çalıştığında meydana gelir. 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:

Ortak Drive'ın yöneticisinden gerçekleştirmeniz gereken işlem için sizi gerekli izinlere sahip olarak eklemesini isteyin.
Ortak Drive'lara kimlerin erişebileceğini ve bunları yönetebileceğini öğrenmek için Drive'ın Rolleri ve izinleri'ni inceleyin. Erişim düzeyleri hakkında daha fazla bilgiyi Ortak Drive oluşturma başlıklı makalede 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ın desteklendiğini belirtecek şekilde ayarlayın.
Klasörü bir 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ı makaleye bakın.

`teamDrivesParentLimit`

Bu hata, kullanıcı ortak Drive'daki bir öğeye birden fazla üst öğe eklemeye çalıştığında ortaya çıkar. 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 çok bağlantı ekleyin. Her kısayolun yalnızca bir üst öğesi olabilir ancak kısayol dosyası ek konumlara kopyalanabilir. Daha fazla bilgi edinmek için Drive dosyası kısayolu oluşturma başlıklı makaleye göz atın.

`UrlLeaseLimitExceeded`

Bu hata, Google Play oyun verilerini uygulamanız üzerinden kaydetmeye çalışırken oluşur. 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 anlık görüntüler yüklemelerini tamamlayın veya iptal edin.

`userRateLimitExceeded`

Bu hata, kullanıcı başına sınıra ulaşıldığında ortaya çıkar. Bu, Google Cloud Console'dan veya Drive arka ucundan alınan 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 projesindeki kullanıcı başına kotayı artırın. Daha fazla bilgi için kota artışı isteğinde bulunun.

Bir kullanıcı, bir Google Workspace hesabının birçok kullanıcısı adına çok sayıda istek yapıyorsa quotaUser parametresini kullanarak alan genelinde yetki verilmiş bir hizmet hesabı kullanmayı düşünebilirsiniz.
İsteği yeniden denemek için eksponansiyel geri yükleme'yi kullanın.

Drive API sınırları hakkında bilgi edinmek için Kullanım sınırları başlıklı makaleye göz atın.

404 hataları

Bu hatalar, istenen kaynağın erişilemediği 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 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:

Dosya bir ortak Drive'da bulunuyorsa ve files.get yöntemini kullanıyorsanız supportsAllDrives sorgu parametresinin true olarak ayarlandığından emin olun.
Kullanıcıya, dosya için okuma erişiminin olmadığını veya dosyanın mevcut olmadığını bildirin.
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 amacıyla isteği yeniden denemek için eksponansiyel geri yükleme'yi kullanın.

500, 502, 503, 504 hataları

Bu hatalar, istek işlenirken beklenmeyen bir sunucu hatası ortaya çıktığında oluşur. Bu hatalara, isteğin zamanlamasının başka bir istekle çakışması veya desteklenmeyen bir işlem isteği (örneğin, sitenin tamamı yerine Google Sites'ta tek bir sayfa için izinlerin güncellenmesi) gibi çeşitli sorunlar neden olabilir.

Aşağıda 5xx hatalarının bir listesi yer almaktadır:

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 amacıyla isteği yeniden denemek için eksponansiyel geri yükleme'yi kullanın.

Hataları çözme

HTTP durum kodu özeti

400 hataları

badRequest

invalidSharingRequest

Paylaşım başarılı oldu, ancak bildirim e-postası doğru bir şekilde teslim edilmedi

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

401 hataları

authError

403 hataları

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

teamDriveMembershipRequired

teamDrivesFolderMoveInNotSupported

teamDrivesParentLimit

UrlLeaseLimitExceeded

userRateLimitExceeded

404 hataları

notFound

429 hataları

rateLimitExceeded

500, 502, 503, 504 hataları

İlgili konular

`badRequest`

`invalidSharingRequest`

`authError`

`activeItemCreationLimitExceeded`

`appNotAuthorizedToFile`

`cannotModifyInheritedTeamDrivePermission`

`dailyLimitExceeded`

`domainPolicy`

`fileOwnerNotMemberOfTeamDrive`

`fileWriterTeamDriveMoveInDisabled`

`insufficientFilePermissions`

`myDriveHierarchyDepthLimitExceeded`

`numChildrenInNonRootLimitExceeded`

`rateLimitExceeded`

`sharingRateLimitExceeded`

`storageQuotaExceeded`

`teamDriveFileLimitExceeded`

`teamDriveMembershipRequired`

`teamDrivesFolderMoveInNotSupported`

`teamDrivesParentLimit`

`UrlLeaseLimitExceeded`

`userRateLimitExceeded`

`notFound`

`rateLimitExceeded`