Halaman ini diterjemahkan oleh Cloud Translation API.

GitHub

Konektor GitHub memungkinkan Anda melakukan operasi penyisipan, penghapusan, pembaruan, dan pembacaan pada data GitHub.

Sebelum memulai

Sebelum menggunakan konektor GitHub, lakukan tugas berikut:

Di project Google Cloud Anda:
- Pastikan konektivitas jaringan telah disiapkan. Untuk mengetahui informasi tentang pola jaringan, lihat Konektivitas jaringan.
- Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
- Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk konektor:
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  Akun layanan adalah jenis Akun Google khusus yang dimaksudkan untuk mewakili pengguna non-manusia yang perlu diautentikasi dan diberi otorisasi untuk mengakses data di Google API. Jika Anda tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk mengetahui informasi selengkapnya, lihat Membuat akun layanan.
- Aktifkan layanan berikut
  - secretmanager.googleapis.com (Secret Manager API)
  - connectors.googleapis.com (Connectors API)
  Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan.
Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

Di GitHub, berdasarkan persyaratan Anda, selesaikan tugas berikut:

Mengonfigurasi konektor

Koneksi khusus untuk sumber data. Artinya, jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan hal berikut:

Di Konsol Cloud, buka halaman Integration Connectors > Connections lalu pilih atau buat project Google Cloud.
Buka halaman Koneksi
Klik + BUAT BARU untuk membuka halaman Buat Koneksi.
Di bagian Location, pilih lokasi untuk koneksi.
1. Wilayah: Pilih lokasi dari menu drop-down.
  Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.
2. Klik NEXT.
Di bagian Detail Koneksi, selesaikan langkah-langkah berikut:
1. Konektor: Pilih GitHub dari daftar drop-down Konektor yang tersedia.
2. Versi konektor: Pilih versi Konektor dari daftar drop-down versi yang tersedia.
3. Di kolom Connection Name, masukkan nama untuk instance Koneksi.
  Nama koneksi harus memenuhi kriteria berikut:
  - Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
  - Huruf harus berupa huruf kecil.
  - Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
  - Nama koneksi tidak boleh melebihi 49 karakter.
4. Secara opsional, masukkan Deskripsi untuk instance koneksi.
5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
6. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
7. Secara opsional, tentukan OwnerLogin: Nama login unik milik pengguna atau organisasi.
8. Jika perlu, tentukan Skema: Gunakan skema untuk membatasi skema yang diambil secara dinamis ke skema project atau repositori tertentu. Untuk mengambil semua skema, jangan tentukan nilai apa pun di kolom ini. Untuk mengetahui informasi tentang skema yang didukung, lihat Skema dan cakupan
9. Jika perlu, konfigurasikan Setelan node koneksi:
  - Jumlah minimum node: Masukkan jumlah minimum node koneksi.
  - Jumlah node maksimum: Masukkan jumlah maksimum node koneksi.
  Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk suatu koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. Untuk memahami pengaruh node terhadap harga konektor, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.
10. Secara opsional, klik + TAMBAHKAN LABEL untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
11. Klik NEXT.
Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
1. Jenis Tujuan: Pilih Jenis Tujuan.
  - Untuk menentukan nama host atau alamat IP tujuan, pilih Alamat host dan masukkan alamat di kolom Host 1.
  - Untuk membuat koneksi pribadi, pilih Endpoint attachment dan pilih lampiran yang diperlukan dari daftar Endpoint Attachment.
    Catatan: Untuk memahami cara membuat lampiran endpoint, lihat Lampiran layanan PSC dan lampiran endpoint. Setelah Anda membuat lampiran endpoint, lampiran tersebut akan terlihat dalam daftar Lampiran Endpoint.
  Jika ingin membuat koneksi publik ke sistem backend dengan keamanan tambahan, Anda dapat mempertimbangkan mengonfigurasi alamat IP keluar statis untuk koneksi Anda, lalu mengonfigurasi aturan firewall untuk hanya mengizinkan alamat IP statis tertentu.
  
  Untuk memasukkan tujuan tambahan, klik +TAMBAHKAN TUJUAN.
2. Klik NEXT.
Di bagian Authentication, masukkan detail autentikasi.
Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.
Klik NEXT.
Tinjau: Tinjau detail koneksi dan autentikasi Anda.
Klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

Client ID: Client ID yang digunakan untuk meminta token akses.
Cakupan: Daftar cakupan yang diinginkan, dipisahkan koma.
Rahasia Klien: Secret Manager Secret yang berisi rahasia klien untuk aplikasi terhubung yang Anda buat.

Contoh konfigurasi koneksi

Bagian ini mencantumkan contoh nilai untuk berbagai kolom yang Anda konfigurasi saat membuat koneksi.

OAuth 2.0 - jenis koneksi kode otorisasi

Nama kolom	Detail
Lokasi	europe-west1
Konektor	GitHub
Versi konektor	1
Nama Koneksi	GitHub-connector
Mengaktifkan Cloud Logging	Tidak
Akun Layanan	Your_Project_Number@serviceaccount
OwnerLogin	souvikg-Your_Owner_Login
Skema
Jumlah minimum node	2
Jumlah maksimum node	50
ID Klien	ClientID
Cakupan	repo repo:status repo_deployment
Rahasia Klien	Rahasia klien
Versi Secret	1

Skema dan cakupan GitHub

Konektor GitHub mendukung skema berikut:

Skema informasi: Skema ini berisi tabel yang berisi informasi pemberian lisensi dan ringkasan tingkat tinggi project dan repositori yang terkait dengan akun yang diautentikasi. Hanya ada satu skema informasi. Untuk mengambil skema informasi, tentukan hal berikut di kolom skema: Information
Skema repositori: Konektor mendukung skema untuk setiap repositori di akun pengguna atau organisasi yang diautentikasi. Gunakan format berikut untuk menentukan skema repositori: Repository_.
Skema project: Konektor mendukung skema untuk setiap project di akun pengguna atau organisasi yang diautentikasi. Gunakan format berikut untuk menentukan skema project: Project_

Untuk mengetahui informasi selengkapnya tentang cakupan, lihat Cakupan GitHub.

Entitas, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke konektor. Misalnya, di konektor database, tabel adalah entitas, di konektor server file, folder adalah entitas, dan di konektor sistem pesan, antrean adalah entitas.
Namun, ada kemungkinan konektor tidak mendukung atau tidak memiliki entity apa pun, sehingga daftar Entities akan kosong.
Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
- Daftar
- Dapatkan
- Buat
- Update
- Hapus
Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihat operasi entitas tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak tercantum dalam daftar Operations.
Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan berbeda-beda dari konektor ke konektor. Biasanya, tindakan akan memiliki beberapa parameter input, dan parameter output. Namun, ada kemungkinan konektor tidak mendukung tindakan apa pun, sehingga daftar Actions akan kosong.

Batasan sistem

Konektor GitHub dapat memproses 2 transaksi per detik, per node, dan membatasi transaksi apa pun yang melampaui batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

Catatan: Jumlah node Integration Connectors akan diskalakan otomatis secara dinamis berdasarkan penggunaan Anda. Namun, jika ingin mencadangkan kapasitas untuk volume besar tanpa menunggu penskalaan otomatis, Anda dapat menyesuaikan nilai node minimum untuk koneksi. Jumlah node yang diperlukan meningkat saat jumlah transaksi yang diproses untuk koneksi bertambah. Sebaliknya, jumlah node yang diperlukan lebih sedikit jika koneksi memproses lebih sedikit transaksi. Untuk mengonfigurasi nilai node, lakukan hal berikut:

Jika Anda adalah pelanggan prabayar, konfigurasikan nilai node minimum dan maksimum di halaman edit koneksi.
Jika Anda adalah pelanggan berbasis langganan, hubungi dukungan.

Jumlah transaksi maksimum yang dapat ditangani oleh sebuah node bergantung pada berbagai faktor. Jadi, sebelum menyesuaikan node minimum untuk mendapatkan throughput yang lebih baik, sebaiknya periksa apakah sistem backend Anda telah disiapkan secara optimal untuk menangani traffic yang diperlukan.

Tindakan

Bagian ini mencantumkan tindakan yang didukung oleh konektor GitHub. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Tindakan UpdatePullRequestBranch

Tindakan ini memperbarui cabang permintaan pull.

Parameter input tindakan UpdatePullRequestBranch

Nama	Jenis	Deskripsi
PullRequestId	string	ID Node permintaan pull.
ExpectedHeadOid	string	OID ref head untuk cabang upstream.
UpdateMethod	string	Metode cabang update yang akan digunakan. Defaultnya adalah 'MERGE'. Nilai yang diizinkan adalah MERGE dan REBASE.

Parameter output tindakan AppsDeployStatus

Tindakan ini menampilkan status 200 (OK) dan memperbarui cabang pull request.

Untuk contoh cara mengonfigurasi tindakan UpdatePullRequestBranch, lihat Contoh.

Tindakan MergePullRequest

Tindakan ini menggabungkan pull request.

Parameter input tindakan MergePullRequest

Nama	Jenis	Deskripsi
PullRequestId	string	ID Node permintaan pull yang akan digabungkan.
ExpectedHeadOid	string	OID yang harus cocok dengan ref head pull request agar penggabungan diizinkan; jika tidak ada, tidak ada pemeriksaan yang dilakukan.
CommitHeadline	string	Judul commit yang akan digunakan untuk commit penggabungan; jika dihilangkan, pesan default akan digunakan.
CommitBody	string	Isi commit yang akan digunakan untuk commit penggabungan; jika dihilangkan, pesan default akan digunakan.
MergeMethod	string	Metode penggabungan yang akan digunakan. Defaultnya adalah 'MERGE'. Nilai yang diizinkan adalah MERGE, SQUASH, dan REBASE.
AuthorEmail	string	Alamat email yang akan dikaitkan dengan penggabungan ini.

Parameter output tindakan MergePullRequest

Tindakan ini menampilkan status 200 (OK) dan menggabungkan pull request.

Untuk contoh cara mengonfigurasi tindakan MergePullRequest, lihat Contoh.

Tindakan DownloadFile

Tindakan ini akan mendownload file dari repositori.

Parameter input tindakan DownloadFile

Nama	Jenis	Wajib	Deskripsi
Jalur	String	Salah	Jalur file di repositori.
Cabang	String	Salah	Nama cabang di repositori tempat file didownload. Nilai defaultnya adalah cabang utama.
LocalPath	String	Salah	Jalur lokal tempat file disimpan setelah didownload.
OutputStream	Biner	Benar	Instance output stream tempat data file ditulis. Aliran output hanya digunakan jika LocalPath tidak disediakan.

Untuk contoh cara mengonfigurasi tindakan DownloadFile, lihat Contoh.

Tindakan UploadFile

Tindakan ini akan mengupload file ke repositori.

Parameter input tindakan UploadFile

Nama	Jenis	Wajib	Deskripsi
Jalur	String	Salah	Jalur file di repositori.
Cabang	String	Salah	Nama cabang di repositori untuk mengupload file. Nilai defaultnya adalah cabang utama.
CommitMessage	String	Salah	Pesan yang menjelaskan perubahan yang dilakukan selama upload file.
SHA	String	Salah	Hash file yang digunakan untuk memverifikasi dan memperbarui file yang ada di repositori.
CommitterName	String	Salah	Pengguna yang melakukan commit file. Nilai defaultnya adalah pengguna yang diautentikasi.
CommitterEmail	String	Salah	Alamat email pengguna yang melakukan commit file. Nilai defaultnya adalah pengguna yang diautentikasi.
AuthorName	String	Salah	Nama penulis yang mengupload file. Nilai defaultnya adalah nama committer atau pengguna yang diautentikasi.
AuthorEmail	String	Salah	Alamat email penulis yang mengupload file. Nilai defaultnya adalah email committer atau email pengguna yang diautentikasi.
LocalPath	String	Salah	Jalur lokal tempat file disimpan setelah didownload.
InputStream	Biner	Benar	Instance aliran input yang digunakan untuk membaca data file. Ini hanya digunakan jika LocalPath tidak ditentukan.
FileData	String	Salah	String berenkode Base64 yang merepresentasikan konten file. Ini hanya digunakan jika LocalPath dan InputStream tidak ditentukan.

Untuk contoh cara mengonfigurasi tindakan UploadFile, lihat Contoh.

Contoh tindakan

Bagian ini menjelaskan cara melakukan beberapa tindakan di konektor ini.

Contoh - UpdatePullRequestBranch

Contoh ini mengambil status deployment aplikasi.

Dalam dialog Configure connector task, klik Action.
Pilih tindakan UpdatePullRequestBranch, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
      {
    "PullRequestId": "PR_kwDOLywhW8537gcA"
      } 
  
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UpdatePullRequestBranch akan memiliki nilai yang mirip dengan berikut ini:

       {
    "pullrequestid": "PR_kwDOLywhW8537gcA"
       }

Contoh - MergePullRequest

Contoh ini menggabungkan pull request.

Dalam dialog Configure connector task, klik Action.
Pilih tindakan MergePullRequest, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

      {
    "PullRequestId": "PR_kwDOLywhW8537gcA",
    "CommitHeadline": "Google MERGE",
    "CommitBody": "This is Google Merge"
      }

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas MergePullRequest akan memiliki nilai yang mirip dengan berikut ini:

        {
    "pullrequestid": "PR_kwDOLywhW8537gcA"
        }

Contoh - Mendownload file dari repositori

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DownloadFile, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
      {
    "Repository": "Google_GitHub_Testing",
    "Path": "Test_Document.txt"
      }
  
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DownloadFile akan memiliki nilai yang mirip dengan berikut ini:

    {
      "Success": true,
      "Details": null,
      "FileData": "SGkgR29vZ2xlIEhvdyBSIHlvdT8KCkknbSBmaW5l"
    }

Contoh - Mengupload file ke repositori

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan UploadFile, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

      {
    "Path": "Sample.txt",
    "Repository": "Google_GitHub_Testing",
    "AuthorName": "Cruz",
    "FileData": "dXBsb2FkIGR0YWEgaW50byB0aGlzIGZpbGUgZnJvbSBHQ1A=",
    "CommitMessage": "TestCommitFrom GCPcloud",
    "CommitterEmail": "Charlie@altrostrat.com",
    "CommitterName": "Charlie",
    "AuthorEmail": "cruz@altrostrat.com"
      }

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UploadFile akan memiliki nilai yang mirip dengan berikut ini:

    {
      "Success": false,
      "Details": "Invalid request.\n\n\"sha\" wasn't supplied. ",
      "CommitSHA": null,
      "FileSHA": null
    }

Contoh operasi entity

Bagian ini menunjukkan cara melakukan beberapa operasi entitas di konektor ini.

Contoh - Mencantumkan semua Cabang

Dalam dialog Configure connector task, klik Entities.
Pilih Branches dari daftar Entity.
Pilih operasi List, lalu klik Selesai.
Di bagian Input Tugas pada tugas Konektor, Anda dapat menetapkan filterClause sesuai kebutuhan Anda.

Contoh - Mencantumkan semua Commit

Dalam dialog Configure connector task, klik Entities.
Pilih Commits dari daftar Entity.
Pilih operasi List, lalu klik Selesai.
Di bagian Input Tugas pada tugas Konektor, Anda dapat menetapkan filterClause sesuai kebutuhan Anda.

Pertimbangan

Commits adalah nama entity. Anda harus meneruskan nilai untuk klausa filter menggunakan tanda kutip tunggal ('), seperti City='Redwood City'. Dengan City adalah nama kolom dan Redwood City adalah nilainya.
Anda dapat menggunakan klausa filter untuk memfilter data berdasarkan kolom. Misalnya, jika ada 20 record dengan name = demo16975280986860, kita dapat memfilter record dengan kolom Address='Redwood City' dan region='us-east1'.

Anda dapat melakukan operasi List pada entitas berikut:

CommitComments, Forks, IssueComments, Issue, IssueAssignees, AssignableUser,Labels, Milestones, PullRequestReviews, PullRequests, PullRequestComments, ReleaseAssets, Releases, Watcher, Users, Repositories, Collaborators, OrganizationTeams, OrganizationsMannequins, OrganizationMember, Organization, Licenses, LicensePermission, LicenseLimitation, LicenseConditions, Projects, dan PullRequestReviewRequests

Contoh - Mendapatkan data Cabang

Dalam dialog Configure connector task, klik Entities.
Pilih Branches dari daftar Entity.
Pilih operasi Get, lalu klik Selesai.
Di sini, ID entitas ditetapkan ke 4. Untuk menyetel ID entitas, di bagian Task Input pada tugas Connectors, klik EntityId, lalu masukkan 4 di kolom Default Value.

Contoh - Mendapatkan data Repositori

Dalam dialog Configure connector task, klik Entities.
Pilih Repositories dari daftar Entity.
Pilih operasi Get, lalu klik Selesai.
Setel ID entity ke 4 yang merupakan Kunci yang akan diteruskan. Untuk menyetel ID entitas, di bagian Task Input pada tugas Connectors, klik EntityId, lalu masukkan 4 di kolom Default Value.

Dalam beberapa kasus, meneruskan satu ID Entitas dapat menyebabkan error karena dua kunci gabungan. Dalam kasus tersebut, gunakan klausa filter dengan kolom yang diperlukan.

Untuk tampilan, operasi Get tidak berfungsi karena tampilan tidak memiliki kunci utama. Sebagai gantinya, Anda dapat menggunakan operasi List dengan filter pada tampilan, yang berfungsi serupa dengan operasi Get.

Anda dapat melakukan operasi Get pada entitas berikut:

CommitComments, Commits, IssueAssignees, Labels, Milestones, PullRequestReviews, PullRequests, PullRequestComments, ReleaseAssets, Release, Topics, Users, Collaborators, Organizations, dan Licenses

Contoh - Membuat rekaman Masalah

Dalam dialog Configure connector task, klik Entities.
Pilih Issues dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
     {
  "Title": "Google_Cloud_GitHub_Issues_Create",
  "Body": "Please check hence raising the Feature Request for the same."
     }
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas Connector:
```
     {
  "Id": "I_kwDOLywhW86Sd-xF"
     } 
```

Contoh - Membuat catatan PullRequests

Dalam dialog Configure connector task, klik Entities.
Pilih PullRequests dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
     {
  "BaseRefName": "main",
  "HeadRefName": "New_Branch",
  "Title": "DEMO_Google_Cloud_PULLRequest",
  "Body": "This is demo Google_Cloud pull"
     }
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas Connector:
```
      {
  "Id": "PR_kwDOLywhW8537gcA"
      }
```

Contoh - Membuat catatan Repositori

Dalam dialog Configure connector task, klik Entities.
Pilih Repositories dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
     {
  "Name": "Google_Cloud_DEMO_REPO",
  "OwnerId": "O_kgDOCaxLsg",
  "Visibility": "PUBLIC"
     }
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas Connector:
```
      {
  "Id": "R_kgDOMhWBEQ"
      } 
```

Contoh - Memperbarui catatan Masalah

Dalam dialog Configure connector task, klik Entities.
Pilih Issues dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
     {
  "Title": "New_Updated_Google_Cloud_Issue",
  "Body": "Newly Updated from Google_Cloud"
     }
```
Tetapkan nilai entityId ke I_kwDOLywhW86Sd-xF. Untuk menetapkan nilai filterClause, klik entityId, lalu masukkan I_kwDOLywhW86Sd-xF di kolom Nilai Default.
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas Connector:
```
     {
  "Id": "I_kwDOLywhW86Sd-xF"
     }
```

Contoh - Memperbarui catatan PullRequests

Dalam dialog Configure connector task, klik Entities.
Pilih PullRequests dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
      {
  "Title": "Updated_Google_Cloud_PULL",
  "Body": "Update New pull Body"
      }
```
Tetapkan nilai untuk entityId ke PR_kwDOLywhW8537gcA. Untuk menetapkan nilai filterClause, klik entityId, lalu masukkan PR_kwDOLywhW8537gcA di kolom Nilai Default.
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas Connector:
```
      {
  "Id": "PR_kwDOLywhW8537gcA"
      } 
```

Contoh - Memperbarui catatan Repositori

Dalam dialog Configure connector task, klik Entities.
Pilih Repositories dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
      {
  "Name": "Updated_New_Google_Cloud_Repo"
      }
```
Tetapkan nilai untuk entityId ke R_kgDOMhWBEQ. Untuk menetapkan nilai filterClause, klik entityId, lalu masukkan R_kgDOMhWBEQ di kolom Nilai Default.
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas Connector:
```
      {
  "Id": "R_kgDOMhWBEQ"
      }
```

Contoh - Menghapus catatan PullRequestReviewRequests

Dalam dialog Configure connector task, klik Entities.
Pilih PullRequestReviewRequests dari daftar Entity.
Pilih operasi Delete, lalu klik Selesai.
Tetapkan nilai untuk filterClause, klik filterClause, lalu masukkan PullRequestId= 'PR_kwDOLywhW85yNWPa' and RequestedReviewerUserId= 'U_kgDOCebPLA' di kolom Nilai Default.

Dalam contoh ini, PullRequestReviewRequests adalah nama tabel dan nilai untuk filterClause harus diteruskan secara langsung.
Misalnya, PullRequestId= 'PR_kwDOLywhW85yNWPa' dan RequestedReviewerUserId= 'U_kgDOCebPLA'.
Di sini, PullRequestId= 'PR_kwDOLywhW85yNWPa' dan RequestedReviewerUserId= 'U_kgDOCebPLA' adalah nilai kunci utama unik yang harus diteruskan.

Menggunakan koneksi GitHub dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

Untuk memahami cara membuat dan menggunakan tugas Konektor di Apigee Integration, lihat Tugas konektor.
Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Aplikasi, lihat Tugas konektor.

Mendapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Forum Cloud.

Langkah berikutnya

Pahami cara menangguhkan dan melanjutkan koneksi.
Pahami cara memantau penggunaan konektor.
Pahami cara melihat log konektor.