Membuat Aplikasi App Engine dengan Admin API

ID region

REGION_ID adalah kode singkat yang ditetapkan Google berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode negara dan provinsi yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal tersebut, ID region bersifat opsional dalam URL.

Pelajari ID region lebih lanjut.

Gunakan App Engine Admin API untuk membuat aplikasi App Engine secara terprogram di project Google Cloud baru. Dengan menggunakan Admin API beserta Cloud Resource Manager API, Anda dapat mengelola project Google Cloud dan aplikasi App Engine secara terprogram.

Membuat aplikasi App Engine akan membuat resource Application untuk project Google Cloud target di lokasi yang ditentukan.

Untuk membuat aplikasi App Engine secara manual di project Google Cloud, lihat topik Mengelola Project, Aplikasi, dan Penagihan untuk bahasa Anda baik dalam lingkungan standar atau lingkungan fleksibel.

Sebelum memulai

Anda harus memenuhi prasyarat berikut sebelum dapat membuat aplikasi App Engine menggunakan Admin API:

  • Anda harus membuat atau sudah memiliki project Google Cloud.
  • Anda harus menjadi pemilik project Google Cloud target.
  • Anda harus dapat mengakses Admin API.

Sebelum akun pengguna lain dapat melakukan tugas pada aplikasi App Engine, pemilik project Google Cloud harus membuat resource Application terlebih dahulu. Misalnya, Anda harus membuat aplikasi App Engine sebelum akun pengguna dengan peran App Engine Deployer dapat men-deploy aplikasi menggunakan akun layanan.

Untuk membuat project Google Cloud:

API

Untuk membuat project Google Cloud secara terprogram, Anda dapat menggunakan Cloud Resource Manager API. Lihat Membuat Project Baru untuk mengetahui detailnya. Lihat contoh singkatnya.

Konsol

Untuk membuat project Google Cloud menggunakan konsol Google Cloud:

Buka halaman Projects

gcloud

Setelah menginstal Google Cloud CLI, Anda dapat menjalankan perintah gcloud CLI berikut untuk membuat project Google Cloud:

gcloud projects create

Jika memilih untuk menggunakan project Google Cloud yang sudah ada, Anda harus memastikan bahwa project tersebut belum berisi resource Application, karena project hanya mendukung satu aplikasi App Engine. Untuk memeriksa apakah project Google Cloud Anda sudah berisi resource Application, Anda dapat menggunakan metode apps.get atau menjalankan gcloud app describe.

Membuat aplikasi App Engine

Untuk membuat aplikasi App Engine dengan Admin API:

  1. Mengizinkan permintaan HTTP Anda, misalnya mendapatkan token akses.

    Mengizinkan akses ke Admin API dapat dilakukan dengan alur OAuth yang berbeda, bergantung pada kebutuhan aplikasi API Anda. Untuk informasi selengkapnya, lihat Mengakses API.

  2. Kirim permintaan POST HTTP menggunakan token akses Anda dan Admin API untuk membuat aplikasi App Engine.

    Anda menentukan resource Application dan menargetkan project Google Cloud dalam permintaan HTTP POST, misalnya:

    POST https://appengine.googleapis.com/v1/apps { "id": "[MY_PROJECT_ID]", "locationId": "[MY_APP_LOCATION]" }
    

    Kolom permintaan HTTP yang diperlukan:

    • id: Project ID dari project Google Cloud target tempat Anda ingin membuat aplikasi App Engine.

    • locationId: Nama region geografis tempat aplikasi App Engine berada seperti yang tercantum dalam App Engine Locations, misalnya us-east1.

      Untuk melihat daftar lengkap lokasi yang didukung, Anda dapat menggunakan metode apps.locations.list.

      Contoh: Izinkan dan jalankan contoh permintaan di APIs Explorer untuk melihat daftar lokasi yang didukung saat ini.

    Lihat referensi Application untuk mengetahui daftar lengkap opsi kolom.

    Contoh perintah cURL:

    curl -X POST -d "{ 'id': '[MY_PROJECT_ID]', 'locationId': '[MY_APP_LOCATION]' }" -H "Content-Type: application/json" -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://appengine.googleapis.com/v1/apps
    

    Dengan keterangan:

    • [MY_PROJECT_ID] adalah ID project target tempat Anda ingin membuat aplikasi App Engine.
    • [MY_APP_LOCATION] adalah lokasi tempat Anda ingin membuat aplikasi App Engine.
    • [MY_ACCESS_TOKEN] adalah token akses yang Anda dapatkan untuk mengizinkan permintaan HTTP Anda.

    Contoh respons:

    {
      "name": "apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f",
      "metadata": {
        "@type": "type.googleapis.com/google.appengine.v1.OperationMetadataV1",
        "method": "google.appengine.v1.Applications.CreateApplication",
        "insertTime": "2016-10-03T20:48:02.099Z",
        "user": "me@example.com",
        "target": "apps/[MY_PROJECT_ID]"
      }
    }
    
  3. Verifikasi bahwa aplikasi App Engine Anda telah dibuat:

    1. Lihat status operasi pembuatan yang sebenarnya:

      HTTP POST yang Anda gunakan di langkah sebelumnya akan menampilkan nama operasi di name, yang digunakan bersama metode GET koleksiapps.operations untuk memeriksa status operasi pembuatan.

      Misalnya, jika kolom name respons adalah:

      "name": "apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f"
      

      Kemudian, kirim permintaan GET HTTP berikut:

      GET https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f
      

      Contoh perintah cURL:

      curl -X GET -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f
      

      Dengan [MY_ACCESS_TOKEN] sebagai token akses Anda dan [MY_PROJECT_ID] sebagai ID project target.

      Contoh respons:

      {
        "name": "apps/[MY_PROJECT_ID]/operations/0a37a032-be3f-4c20-98b4-e3300447450f",
        "metadata": {
          "@type": "type.googleapis.com/google.appengine.v1.OperationMetadataV1",
          "method": "google.appengine.v1.Applications.CreateApplication",
          "insertTime": "2016-10-03T20:48:02.099Z",
          "endTime": "2016-10-03T20:48:18.272Z",
          "user": "me@example.com",
          "target": "apps/[MY_PROJECT_ID]"
        },
        "done": true,
        "response": {
          "@type": "type.googleapis.com/google.appengine.v1.Application",
          "id": "[MY_PROJECT_ID]",
          "locationId": "[MY_APP_LOCATION]"
        }
      }
      
    2. Verifikasi bahwa aplikasi App Engine telah dibuat di project Anda:

      Untuk melihat detail tentang versi, gunakan metode GET dari koleksi apps. Anda harus menentukan project yang di-deploy dalam permintaan GET HTTP, misalnya:

      GET https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]
      

      Contoh perintah cURL:

      curl -X GET -H "Authorization: Bearer [MY_ACCESS_TOKEN]" https://appengine.googleapis.com/v1/apps/[MY_PROJECT_ID]/
      

      Dengan [MY_ACCESS_TOKEN] sebagai token akses Anda dan [MY_PROJECT_ID] sebagai ID project target.

      Contoh respons:

      {
        "name": "apps/[MY_PROJECT_ID]",
        "id": "[MY_PROJECT_ID]",
        "authDomain": "gmail.com",
        "locationId": "us-central",
        "defaultHostname": "[MY_PROJECT_ID].[REGION_ID].r.appspot.com",
        "defaultBucket": "[MY_PROJECT_ID].[REGION_ID].r.appspot.com"
      }
      

      REGION_ID adalah kode singkat yang Google tetapkan berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode provinsi dan negara yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal ini, ID region bersifat opsional dalam URL.

Langkah selanjutnya