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 alabilir, her uygulamanın desteklenen MIME türleri, dosya uzantıları ve diğer ayrıntıları hakkında bilgi edinebilirsiniz.

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

Kullanıcılarla ilgili ayrıntıları alma

Bir Drive kullanıcısıyla ilgili bilgileri about örneği olarak döndürmek için get yöntemini kullanın. Döndürülen değerler bayt cinsinden ölçülür.

Yanıt içinde döndürülecek alanları belirtmek için fields system parametresini get yönteminde ayarlamanız gerekir. Çoğu Drive yönteminde bu işlem yalnızca varsayılan olmayan alanları döndürmek için gereklidir ancak about kaynağı için zorunludur. Parametreyi atlarsanız yöntem hata döndürür. Daha fazla bilgi için Belirli alanları döndürme başlıklı makaleyi inceleyin.

Aşağıdaki kod örneğinde, istekte sorgu parametresi olarak birden fazla fields değerinin nasıl sağlanacağı gösterilmektedir. Yanıt, isteğ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 adı düz metin olarak.
  • PHOTO_LINK: Kullanıcının profil fotoğrafının URL'si.
  • PERMISSION_ID: Kullanıcının Permission kaynaklarındaki kimliği.
  • EMAIL_ADDRESS: kullanıcının e-posta adresi

Kullanıcı uygulamalarını listeleme

Google Drive uygulamaları Google Workspace Marketplace'te listelenir ve Drive'ı daha kullanışlı hale getirmek için kullanılır. Örneğin, Google Dokümanlar uygulaması veya Dokümanlar'da dokümanları imzalamak için kullanılan bir eklenti. Daha fazla bilgi için Google Drive uygulamalarını kullanma başlıklı makaleyi inceleyin.

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

Yanıt içinde döndürülecek alanları belirtmek istiyorsanız fields system parametresini ayarlayabilirsiniz. fields parametresini belirtmezseniz sunucu varsayılan bir alan grubu döndürür. Daha fazla bilgi için Belirli alanları döndürme başlıklı makaleyi inceleyin.

Aşağıdaki kod örneğinde, istekte kullanıcının yüklü tüm uygulamalarının listesinin nasıl döndürüleceği gösterilmektedir. Yanıt, isteğ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: Arama sonuçlarını, virgülle ayrılmış dosya uzantıları listesini kullanarak filtreleyin. Uygulama sorgu kapsamındaki ve listelenen dosya uzantılarını açabilen 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ı örnekleri arasında Microsoft Word için docx ve Microsoft PowerPoint için pptx yer alır. Dosya uzantılarıyla ilgili daha fazla örnek için Google Workspace dokümanları için MIME türlerini dışa aktarma başlıklı makaleyi inceleyin.

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

  • appFilterMimeTypes: Arama sonuçlarını virgülle ayrılmış bir MIME türleri listesi kullanarak filtreleyin. Uygulama sorgusu kapsamındaki, listelenen MIME türlerini açabilen uygulamalar yanıta dahil edilir. appFilterExtensions da sağlanırsa 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, 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ı makaleyi inceleyin.

    Aşağıdaki kod örneğinde, sorgu parametresi olarak birden fazla 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çiminden bazı uzantılarla birlikte BCP 47 tarafından tanımlanan 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 yer alı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.

Kullanıcı uygulamasını kimliğe göre alma

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

Aşağıdaki kod örneğinde, istekte sorgu parametresi olarak appId nasıl sağlanacağı gösterilmektedir. Yanıt, isteğ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.

Deneyebileceğiniz bazı sonraki adımlar: