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, size yardımcı olabilecek ek ayrıntılar içeren bir JSON nesnesi ve hatanın nasıl ele alınacağını belirler.

Google Drive uygulamaları, karşılaşılabilecek tüm hataları yakalayıp işlemelidir dikkatinizi çekebilir. Bu kılavuzda, bu sorunu çözmek için Belirli Drive API hataları.

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, isteğin eksik olması nedeniyle isteğin kabul edilemez olduğu anlamına gelir. gerekli parametredir.

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'un reason alanı. 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ıya (paylaşıcıya) şu nedenle paylaşımda bulunamadığı hakkında bilgi verin: Bildirim e-postası hedef e-posta adresine gönderilemedi. İlgili içeriği oluşturmak için kullanılan kullanıcıların doğru e-posta adresine sahip olduğundan ve e-posta alırsınız.

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 paylaşma Ayarlar'ı dosyanın ait olduğu Google Workspace alanına ait olmalıdır. Bu ayarlar alan dışında paylaşmayı veya ortak drive'ı paylaşmayı yasaklamak, izin verilmez.

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. Bu hata, kapsama dahil edin. 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, kullanıcıyı OAuth akışı üzerinden yönlendirin: Google Drive API kapsamları başlıklı makaleyi inceleyin.

403 hataları

Bu hatalar, kullanım sınırının aşıldığı veya kullanıcının sahip olmalıdır. Nedeni belirlemek için verinin reason alanını değerlendirin döndüren JSON dosyasıdır.

Drive API sınırları hakkında bilgi edinmek için Kullanım sınırları başlıklı makaleyi inceleyin. Drive klasörü hakkında bilgi hakkında bilgi edinmek istiyorsanız Dosya ve klasör sınırları başlıklı makaleyi inceleyin.

activeItemCreationLimitExceeded

Bu sayı için sınır değer olduğunda activeItemCreationLimitExceeded hatası oluşur Hesap başına oluşturulan öğe sayısı aşıldı. Her kullanıcı en fazla 500 bir hesap tarafından oluşturulmuş bir milyon öğe. Daha fazla bilgi için bkz. User-item sınır.

{
 "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 hesap oluşturmasını engellediğini bildirin ve 500 milyondan fazla öğe içeriyor.

2. Kullanıcının aynı hesapta öğeler oluşturması gerekiyorsa nesneleri kalıcı olarak silebilir. Aksi takdirde farklı bir hesap kullanabilirler. bir reklam grubu olmalıdır.

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 bir 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ç ve kullanıcıdan dosyayı açmasını isteyin.
• Kullanıcıdan Drive'daki Birlikte aç içerik menüsünü kullanarak dosyayı açmasını isteyin Uygulamanızın kullanıcı arayüzü.
• files.get yöntemini kullanarak web sitesindeki isAppAuthorized alanını kontrol edin doğrulamak için files kaynağı Uygulama tarafından oluşturulan veya açılmış olan dosyadır.

cannotModifyInheritedTeamDrivePermission

Bu hata, bir kullanıcı bir öğe ekleyin. Devralınan izinler öğelerden kaldırılamaz in a ortak drive'da. 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 doğrudan veya dolaylı üst öğedir. Daha fazla bilgi için bkz. İzin yayılımı. Şunları yapabilirsiniz: CANNOT TRANSLATE permissions.permissionDetails bu ortak drive öğesindeki izinlerin devralınıp alınmadığını görmek için kaynak ya da doğrudan uygulanır.

dailyLimitExceeded

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

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

Bu hata, uygulamanın sahibi bir kota sınırı belirlediğinde ortaya çıkar ve yeniden pazarlama yöntemini kullanabilirsiniz. Bu hatayı düzeltmek için tüm "Günlük sorgu sayısı" kotası ekleyebilirsiniz.

domainPolicy

Bu hata, kullanıcının alan adının politikası erişime izin vermediğinde ortaya çıkar. Uygulamanızın yakınından geçin. Aşağıdaki JSON örneği, alan adının bir temsilidir şu hata mesajını görürsünüz:

{
  "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 içindeki dosyalara erişmesine izin vermediğini bildirin Drive'a dokunun.
2. Kullanıcıdan alan yöneticisiyle iletişime geçerek için erişim isteğinde bulunmasını isteyin en iyi şekilde yararlanabilirsiniz.

fileOwnerNotMemberOfTeamDrive

Bu hata, bir dosyayı ortak drive'a taşımaya çalışırken ve dosyanın sahibi üye değil. Aşağıdaki JSON örneği bunun bir temsilidir hata:

{
  "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 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 bkz. Oluşturma ve nasıl oluşturulur.

fileWriterTeamDriveMoveInDisabled

Bu hata, alan adı yöneticisi Öğeleri ortak drive'a taşımak için role=writer. Kullanıcı öğe, hedef ortak Drive'da izin verilenden daha az izne sahip. İlgili içeriği oluşturmak için kullanılan aşağıdaki JSON örneği bu hatanın bir 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 her iki kaynakta da aynı yönetici kullanıcı hesabını kullanın. ve hedef ortak drive'lar.

insufficientFilePermissions

Bu hata, kullanıcının bir dosyaya yazma erişimi olmadığında ve adlı uygulama dosyayı değiştirmeye çalışıyor. Aşağıdaki JSON örneği, bir temsil eder:

{
  "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 istekte bulunmasını isteyin. düzenleme erişimi. Web sayfası tarafından alınan meta verilerde kullanıcı erişim düzeylerini de kontrol edebilirsiniz. files.get yöntemini kullanır ve İzinler eksik olduğunda salt okunur kullanıcı arayüzü.

myDriveHierarchyDepthLimitExceeded

için sınır değer olduğunda myDriveHierarchyDepthLimitExceeded hatası oluşur iç içe yerleştirilmiş klasör düzeyi sayısı aşıldı. Kullanıcının Drive'da en fazla 100 düzeyde iç içe yerleştirilmiş klasör olabilir. Örneğin, Daha fazla bilgi için bkz. Klasör derinliği sınır.

{
 "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, şundan daha fazla klasör yerleştirmeyi engellediğini bildirin: 100 seviye derinliğinde.
2. Kullanıcının iç içe yerleştirilmiş başka bir klasör oluşturması gerekiyorsa yeniden organize etmesi için ona talimat verin üst klasörün 100'den az düzeyde derinliğe sahip olmasını sağlayın veya üst klasörden farklı bir klasör oluşturmanız gerekir.

numChildrenInNonRootLimitExceeded

Bu hata, bir klasörün alt öğe sayısı (klasörler, klasörler ve dosyalar ve kısayollar) aşıldığından emin olun. Her biri için 500.000 öğe sınırı var. klasörleri, dosyaları ve kısayolları doğrudan bir klasöre koyabilirsiniz. Alt klasörlere yerleştirilmiş öğeler hesaba katılmaz. Daha fazla bilgi için Drive klasör sınırlamaları, Google Drive'a gidin.

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ıyı, Drive'ın 500.000 öğe.
• Kullanıcının tam klasöre daha fazla öğe eklemesi gerekiyorsa klasörü 500.000'den az öğe içerecek şekilde yeniden düzenleyin veya benzer bir öğe adlı bir klasör içerir.

rateLimitExceeded

Bu hata, projenin oran sınırına ulaşıldığında ortaya çıkar. Bu sınır talebin türüne göre değişir. Aşağıdaki JSON örneği, bir temsil eder:

{
 "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ışı isteğinde bulunun.
• Daha az istek yapmak için toplu istekler API çağrıları.
• Şu işlemi yeniden denemek için eksponansiyel geri yükleme yöntemini kullanın: isteği gönderin.

sharingRateLimitExceeded

Bu hata, kullanıcı bir paylaşım sınırına ulaştığında ve genellikle e-posta sınırı uygulanır. Aşağıdaki JSON örneği bunun bir temsilidir hata:

{
 "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 sitenin birçok kullanıcısı adına çok sayıda istek iletiyorsa Google Workspace hesabı: Alan genelinde bir hizmet hesabı kullanmayı düşünebilirsiniz. yetki quotaUser parametresini kaldırın.

storageQuotaExceeded

Bu hata, kullanıcı depolama alanı sınırına ulaştığında oluşur. Aşağıdakiler JSON örneği bu hatanın bir 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 Google Workspace depolama alanı ve yükleme kontrol edin.

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

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

teamDriveFileLimitExceeded

Bu hata, bir kullanıcı bir ortak drive. Bir kullanıcının ortak drive'ındaki her klasörün 500.000 öğe sınırı vardır. çeşitli kısayolları kullanabilirsiniz. Bu sınır, öğe sayısına değil depolama alanı kullanımını kapsar. Daha fazla bilgi edinmek için Şu makaledeki ortak Drive sınırları: Google Drive'a gidin.

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. Ortak Drive'lar dosyaları düzenlemek ve aramak zor olabilir.

teamDriveHierarchyTooDeep

Öğe sayısı sınırı belirlendiğinde teamDriveHierarchyTooDeep hatası oluşur. Ortak Drive'da iç içe yerleştirilmiş klasör düzeyi aşıldı. Kullanıcının ortak Drive'ı: 100'den fazla düzeyde iç içe yerleştirilmiş klasör içermelidir. Daha fazla bilgi için bkz. Klasör derinliği sınırı.

{
 "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 şundan daha fazla klasör yerleştirilmesini engellediğini belirtin: 100 seviye derinliğinde.
2. Kullanıcının iç içe yerleştirilmiş başka bir klasör oluşturması gerekiyorsa yeniden organize etmesi için ona talimat verin üst klasörün 100'den az düzeyde derinliğe sahip olmasını sağlayın veya üst klasörden farklı bir klasör oluşturmanız gerekir.

teamDriveMembershipRequired

Bu hata, kullanıcı içinde bulunduğu bir ortak drive'a erişmeye çalıştığında üye değil. 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 sizi uygun izinlerin olması gerekir.

2. Drive'daki Roller ve izinleri kimin yönetebileceğini ortak drive'lar. Erişim düzeyleri hakkında ek bilgileri de bulabilirsiniz: Drive'a ekleyin.

teamDrivesFolderMoveInNotSupported

Bu hata, bir kullanıcı Klasörüm'den bir klasörü taşımaya çalıştığında Drive'ı ortak drive'a ekleyin. Aşağıdaki JSON örneği, bir temsil eder:

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

• Klasördeki öğeleri tek tek ortak drive'a taşımak için Drive API'si. supportsAllDrives=true parametresini Drive'ım ve ortak drive'lar için destek.

• Klasörü bir ortak drive'a taşımanız gerekiyorsa Drive kullanıcı arayüzü. Daha fazla bilgi edinmek için Klasörleri paylaşılan öğelere taşıma Drive'lar yönetici olarak devre dışı bırakılır.

teamDrivesParentLimit

Bu hata, bir kullanıcı bir öğeye birden fazla üst öğe eklemeye çalıştığında bir ortak drive'a dokunun. 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 dosyası olarak kaydedebilirsiniz. Bir kısayolun yalnızca bir üst öğesi olabilir, ancak kısayol dosyası ek konumlara kopyalandı. Daha fazla bilgi için kısayolu kullanabilirsiniz.

UrlLeaseLimitExceeded

Bu hata, Google Play oyun verilerini bir uygulamadır. 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, oluşturmadan önce anlık görüntü için tüm yükleme işlemlerini tamamlayın veya iptal edin daha fazla.

userRateLimitExceeded

Bu hata, kullanıcı başına sınıra ulaşıldığında ortaya çıkar. Bu bir Google Cloud konsolundan veya Drive'dan arka uçta olması gerekir. 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ışı isteğinde bulunun.

• Bir kullanıcı bir sitenin birçok kullanıcısı adına çok sayıda istek iletiyorsa Google Workspace hesabı kullanıyorsanız alan genelinde bir hizmet hesabı kullanmayı düşünebilirsiniz. yetki quotaUser parametresini kaldırın.

• Şu işlemi yeniden denemek için eksponansiyel geri yükleme yöntemini kullanın: isteği gönderin.

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 dosyaya veya dosyaya okuma erişimi olmadığında mevcut değil. 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 bir ortak drive'daysa ve files.get yöntemini kullanıyorsanız supportsAllDrives sorgu parametresi true olarak ayarlandı.
2. Kullanıcıya dosya veya dosya için okuma erişimi olmadığını bildirme mevcut değil.
3. Kullanıcıdan dosyanın sahibiyle iletişim kurmasını ve dosyası olarak kaydedebilirsiniz.

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 sorguda çok fazla istek gönderdiğinde teşekkür ederiz. 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 Backoff'u kullanabilirsiniz.

500, 502, 503, 504 hataları

Bu hatalar, taşıma işlemi sırasında beklenmedik bir sunucu hatası oluştuğunda, isteği gönderin. İsteğin zamanlaması da dahil olmak üzere çeşitli sorunlar bu hatalara neden olabilir desteklenmeyen bir işleme yönelik başka bir istek veya istekle (ör. Google Sites'ta tek bir sayfa için izinleri güncellemeye çalışırken bir şablondur.

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 Backoff'u kullanabilirsiniz.

İlgili konular

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