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 edinebilirsiniz.

  • 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ılarıyla birlikte alabilirsiniz.

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.

get() yöntemi, yanıtta döndürülecek alanları listelemek için fields parametresini gerektirir. Parametreyi atlarsanız yöntem bir hata döndürür. Tam olarak ihtiyacınız olan alanları döndürmek için Belirli alanları 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 değerinin 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 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 (ör. Google Dokümanlar uygulaması veya dokümanları imzalamak için Dokümanlar'da 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.

fields parametresini, yanıtta döndürülecek alanları listeleyecek şekilde ayarlayabilirsiniz. Tam olarak ihtiyacınız olan alanları döndürmek için Belirli alanları döndürme bölümüne bakın.

Örnek göster

Aşağıdaki kod örneğinde, kullanıcının yüklü tüm uygulamalarının listesinin istekle 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. Uygulama sorgusu kapsamındaki ve listelenen dosya uzantılarını açabilen uygulamalar yanıta dahil edilir. appFilterMimeTypes ayrıca sağlanırsa elde edilen iki uygulama listesinin bir birleşimi döndürülür. Microsoft Word için docx ve Microsoft PowerPoint için pptx gibi uzantılar buna örnek gösterilebilir. Dosya uzantılarıyla ilgili daha fazla örnek için Google Workspace belgeleri için MIME türlerini dışa aktarma başlıklı makaleyi inceleyin.

    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: Arama sonuçlarını, MIME türlerinin virgülle ayrılmış bir listesini kullanarak filtreleyin. Uygulama sorgusu kapsamındaki ve listelenen MIME türlerini açabilen uygulamalar yanıta dahil edilir. appFilterExtensions da sağlanırsa elde edilen iki uygulama listesinin bir 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'ın desteklediği 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: BCP 47 tarafından tanımlanan bir dil veya yerel ayar kodunu ve Unicode'un LDML biçimindeki bazı uzantıları kullanarak arama sonuçlarını filtreleyin. Dil kodlarına örnek olarak İngilizce (ABD) için en-us ve Fransızca (Kanada) için fr-ca verilebilir.

    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.

Örnek göster

Aşağıdaki kod örneğinde, istekte sorgu parametresi olarak appId değerinin 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/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 birkaç sonraki adım: