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:
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 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 kullanarakfiles
kaynağındakiisAppAuthorized
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:
- Kullanıcıya, söz konusu alanın, uygulamanızın Drive'daki dosyalara erişmesine izin vermediğini bildirin.
- 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:
Ü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.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:
- Kullanıcıya, Drive'ın 100 düzeyden daha derine klasörler yerleştirilmesini engellediğini bildirin.
- 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:
- Büyük miktarda dosya paylaşırken e-posta göndermeyin.
- 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:
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.
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:
- Kullanıcıyı, ortak Drive'ların 100 düzeyden daha derine klasörler yerleştirilmesini engellediğini bildirin.
- 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:
Ortak Drive'ın yöneticisinden, gerçekleştirmeniz gereken işlem için sizi uygun izinleri eklemesini isteyin.
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:
- Dosya ortak Drive'da bulunuyorsa ve
files.get
yöntemini kullanıyorsanızsupportsAllDrives
sorgu parametresinintrue
olarak ayarlandığından emin olun. - Kullanıcıya, dosya için okuma erişimi 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 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.