Google Apps Komut Dosyası işlevlerini yürütme

Google Apps Komut Dosyası API'si, erişiminiz olan bir komut dosyası projesinde bir işlevi uzaktan yürütmenize olanak tanır. Uygulamanız, belirli bir Apps Komut Dosyası işlevini çağırabilir, gerekirse giriş parametreleri sağlayabilir ve yanıt alabilir.

Bu sayfadaki örnekler, API ile yaygın yürütme işlemlerinin nasıl gerçekleştirilebileceğini gösterir. Özel yetkilendirme koşulları da dahil olmak üzere daha fazla bilgi için İşlev yürütme kılavuzuna bakın.

Bu örneklerde, komut dosyası proje kimliğini nerede sağlayacağınızı belirtmek için scriptId yer tutucuları kullanılır. Komut dosyası kimliğini bulmak için aşağıdaki adımları uygulayın:

  1. Apps Komut Dosyası projesinde, sol üstte Proje Ayarları'nı tıklayın.
  2. "Komut dosyası kimliği"nin yanındaki Kopyala'yı tıklayın.

İşlev yürütün

Aşağıdaki scripts.run isteği, listFolderContent adlı bir Apps Komut Dosyası işlevini çağırır ve Google Drive folderId ile bir tam sayıyı MAX_SIZE bağımsız değişken olarak iletir. İşlev, geliştirme modunda yürütülür. Bu nedenle, yürütülebilir olarak hangi sürüm dağıtılırsa dağıtılsın, işlevin en son kaydedilen sürümü yürütülür.

İstek protokolü aşağıda gösterilmiştir. İşlevleri yürütme kılavuzunda, Google API istemci kitaplıklarını kullanarak farklı dillerde nasıl çalıştırma isteği uygulanacağı gösterilmektedir.

POST https://script.googleapis.com/v1/scripts/scriptId:run
 
{
  "function": "listFolderContent",
  "parameters": [
    folderId,
    MAX_SIZE
  ],
  "devMode": true
}

Çağrılan Apps Komut Dosyası işlevi tamamlandıktan sonra bu isteğe verilen yanıt, yürütme sonuçlarını veya bir hata yanıtını içerir. Bu örnekte, işlev başarıyla bir dosya adı dizisi döndürür:

{
  "response": {
    "result": [
      "fileTitle1",
      "fileTitle2",
      "fileTitle3"
    ]
  },
}

İşlev, Apps Komut Dosyası yürütme sırasında bir hatayla karşılaşırsa yanıt şu şekilde görünebilir:

{
  "response": {
    "error": {
      "code": 3,
      "message": "ScriptError",
      "details": [{
        "@type": "type.googleapis.com/google.apps.script.v1.ExecutionError",
        "errorMessage": "The script enountered an exeception it could not resolve.",
        "errorType": "ScriptError",
        "scriptStackTraceElements": [{
          "function": "listFolderContent",
          "lineNumber": 14
        }]
      }]
    }
  }
}