Kullanıcı bilgilerini döndürme

Google Drive, Drive kullanıcıları hakkında bilgi toplamak için iki seçenek sunar:

  • about kaynağını kullanarak kullanıcı, kullanıcının Drive ayarları ve sistem özellikleri hakkında bilgi alabilirsiniz.

  • apps kaynağını kullanarak kullanıcının yüklü uygulamalarının listesini, her uygulamanın desteklenen MIME türleri, dosya uzantıları ve diğer ayrıntılarla birlikte içeren bir listesini alabilirsiniz.

Bu kılavuzda, Drive'da kullanıcı bilgilerini nasıl alabileceğiniz açıklanmaktadır.

Kullanıcı hakkındaki bilgileri getirme

about örneği olarak bir Drive kullanıcısıyla ilgili bilgileri döndürmek için about.get yöntemini kullanın. about.get yöntemi, yöntem çağrınızda fields sorgu parametresini gerektirir. Döndürülen değerler bayt cinsinden ölçülür. Daha fazla bilgi için Bir dosyanın belirli alanlarını döndürme bölümüne bakın.

Örnek göster

Aşağıdaki kod örneğinde, istekte sorgu parametresi olarak birden fazla fields öğesinin nasıl sağlanacağı gösterilmektedir. Yanıt, istek için alan değerlerini döndürür.

İstek

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

Yanıt

{
  "kind": "drive#about",
  "user": {
    "kind": "drive#user",
    "displayName": "DISPLAY_NAME",
    "photoLink": "PHOTO_LINK",
    "me": true,
    "permissionId": "PERMISSION_ID",
    "emailAddress": "EMAIL_ADDRESS"
  },
  "storageQuota": {
    "usage": "10845031958",
    "usageInDrive": "2222008387",
    "usageInDriveTrash": "91566"
  }
}

Yanıt aşağıdaki değerleri içerir:

  • DISPLAY_NAME: Kullanıcının düz metin olarak yazılan adı.
  • PHOTO_LINK: Kullanıcının profil fotoğrafının URL'si.
  • PERMISSION_ID: Kullanıcının Permission kaynakları içindeki kimliği.
  • EMAIL_ADDRESS: kullanıcının e-posta adresi

Kullanıcının uygulamalarıyla ilgili bilgileri getirme

Google Workspace Marketplace'te listelenen Google Drive uygulamaları, Drive'ı daha kullanışlı hale getirmek için kullanılır. Bu uygulamalar, Google Dokümanlar uygulaması veya dokümanları imzalamak için Dokümanlar'da kullanılan bir eklenti gibi Drive'ı daha kullanışlı hale getirmek amacıyla kullanılır. Daha fazla bilgi edinmek için Google Drive uygulamalarını kullanma başlıklı makaleye göz atın.

Kullanıcının tüm yüklü uygulamalarının listesini apps örneği olarak döndürmek için hiçbir parametre olmadan apps.list yöntemini kullanın.

Örnek göster

Aşağıdaki kod örneğinde, kullanıcının istekte yüklü olan tüm uygulamalarının listesinin nasıl döndürüleceği gösterilmektedir. Yanıt, istek için alan değerlerini döndürür.

İstek

GET https://www.googleapis.com/drive/v3/apps

Yanıt

{
  "kind": "drive#appList",
  "selfLink": "https://www.googleapis.com/drive/v3/apps",
  "items": [
    {
      "kind": "drive#app",
      "id": "ID",
      "name": "Google Sheets",
      "supportsCreate": true,
      "supportsImport": true,
      "supportsMultiOpen": false,
      "supportsOfflineCreate": true,
      "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
      "productId": "PRODUCT_ID"
    }
  ],
  "defaultAppIds": [
    "ID"
  ]
}

Yanıt aşağıdaki değerleri içerir:

  • ID: uygulama kimliği.
  • PRODUCT_ID: Bu uygulamanın ürün listeleme kimliği.

Sorgu parametreleriyle kullanıcı uygulamalarını listeleme

Belirli bir uygulamayı bulmak için isteğe bağlı sorgu parametrelerinden birini veya daha fazlasını kullanın:

  • appFilterExtensions: Dosya uzantılarının virgülle ayrılmış bir listesini kullanarak arama sonuçlarını filtreleyin. Listelenen dosya uzantılarını açabilen ve uygulama sorgusu kapsamında bulunan uygulamalar yanıta dahil edilir. appFilterMimeTypes de sağlanırsa sonuçta elde edilen iki uygulama listesinin birleşimi döndürülür. Uzantılara örnek olarak Microsoft Word için docx ve Microsoft PowerPoint için pptx verilebilir. Dosya uzantılarıyla ilgili daha fazla örnek için Google Workspace dokümanları için MIME türlerini dışa aktarma bölümüne bakın.

    Aşağıdaki kod örneğinde, sorgu parametresi olarak birden fazla dosya uzantısının nasıl sağlanacağı gösterilmektedir: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

  • appFilterMimeTypes: MIME türlerinin virgülle ayrılmış listesini kullanarak arama sonuçlarını filtreleyin. Uygulama sorgusu kapsamında, listelenen MIME türlerini açabilen uygulamalar yanıta dahil edilir. appFilterExtensions de sağlanmışsa sonuçta elde edilen iki uygulama listesinin birleşimi döndürülür. MIME türlerine örnek olarak Google Formlar için application/vnd.google-apps.form ve Google Sites için application/vnd.google-apps.site verilebilir. MIME türleriyle ilgili daha fazla örnek için Google Workspace ve Google Drive'da desteklenen MIME türleri başlıklı makaleye göz atın.

    Aşağıdaki kod örneğinde, sorgu parametresi olarak birden çok MIME türünün nasıl sağlanacağı gösterilmektedir: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site.

  • languageCode: Arama sonuçlarını Unicode'un LDML biçimindeki bazı uzantılarla BCP 47 tarafından tanımlandığı gibi bir dil veya yerel ayar kodu kullanarak filtreleyin. Dil kodu örnekleri arasında İngilizce (ABD) için en-us ve Fransızca (Kanada) için fr-ca bulunmaktadır.

    Aşağıdaki kod örneğinde, sorgu parametresi olarak birden fazla dil kodunun nasıl sağlanacağı gösterilmektedir: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

Kimliğe göre kullanıcı uygulamasını al

Ayrıntılı uygulama bilgilerini apps örneği olarak indirmek için uygulama kimliğiyle birlikte apps.get yöntemini kullanın.

Örnek göster

Aşağıdaki kod örneğinde, istekte sorgu parametresi olarak nasıl appId sağlanacağı gösterilmektedir. Yanıt, istek için alan değerlerini döndürür.

İstek

GET https://www.googleapis.com/drive/v3/apps/APP_ID

Yanıt

{
  "kind": "drive#app",
  "id": "ID",
  "name": "Google Sheets",
  "supportsCreate": true,
  "supportsImport": true,
  "supportsMultiOpen": false,
  "supportsOfflineCreate": true,
  "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
  "productId": "PRODUCT_ID"
}

Yanıt aşağıdaki değerleri içerir:

  • ID: uygulama kimliği.
  • PRODUCT_ID: Bu uygulamanın ürün listeleme kimliği.

Aşağıdaki adımları deneyebilirsiniz: