Marketo

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

Sebelum memulai

Sebelum menggunakan konektor Marketo, lakukan tugas berikut:

  • Di project Google Cloud Anda:
    • Pastikan konektivitas jaringan sudah 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 tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk 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.

Mengonfigurasi konektor

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

  1. Di konsol Cloud, buka halaman Konektor Integrasi > Koneksi, lalu pilih atau buat project Google Cloud.

    Buka halaman Koneksi

  2. Klik + Buat baru untuk membuka halaman Buat Koneksi.
  3. Di bagian Location, pilih lokasi untuk koneksi.
    1. Region: Pilih lokasi dari menu drop-down.

      Region yang didukung untuk konektor meliputi:

      Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

    2. Klik Berikutnya.
  4. Di bagian Connection Details, selesaikan tindakan berikut:
    1. Konektor: Pilih Marketo dari menu drop-down Konektor yang tersedia.
    2. Versi konektor: Pilih versi Konektor dari menu drop-down versi yang tersedia.
    3. Di kolom Connection Name, masukkan nama untuk instance Connection.

      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 Description untuk instance koneksi.
    5. Service Account: Pilih akun layanan yang memiliki peran yang diperlukan.
    6. Secara opsional, konfigurasikan Setelan node koneksi:

      • Jumlah node minimum: Masukkan jumlah minimum node koneksi.
      • Maximum number of nodes: Masukkan jumlah maksimum node koneksi.

      Node adalah unit (atau replika) koneksi yang memproses transaksi. Semakin banyak node yang diperlukan untuk memproses lebih banyak transaksi untuk koneksi, dan sebaliknya, semakin sedikit node yang diperlukan untuk memproses lebih sedikit transaksi. Untuk memahami pengaruh node terhadap harga konektor Anda, 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.

    7. Secara opsional, klik + Tambahkan label untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
    8. Klik Berikutnya.
  5. Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
    1. Jenis Tujuan: Anda dapat menentukan detail tujuan sebagai alamat host atau lampiran layanan. Pilih salah satu jenis tujuan berikut:
      • Alamat host: Jika Anda ingin menentukan nama host atau alamat IP tujuan.
      • Lampiran layanan: Jika Anda ingin menentukan endpoint pribadi untuk alamat IP internal. Lampiran layanan memungkinkan Anda menyembunyikan alamat IP internal dari jaringan eksternal. Anda dapat membuat lampiran layanan di Google Cloud, dengan menggunakan fitur Private Service Connect. Untuk informasi tentang cara mengonfigurasi Private Service Connect, lihat Memublikasikan layanan terkelola.

      Berdasarkan pilihan jenis tujuan, masukkan alamat host atau nama lampiran layanan.

      Untuk memasukkan tujuan tambahan, klik +Tambahkan tujuan.

    2. Klik Berikutnya.
  6. Di bagian Authentication, masukkan detail autentikasi.
    1. Pilih Jenis autentikasi dan masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh koneksi Marketo:

      • Kredensial Klien OAuth 2.0
      • Nama pengguna dan sandi

      2. Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

    2. Klik Berikutnya.
  7. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
  8. Klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

  • Kredensial Klien OAuth 2.0
    • Client ID: Client ID yang disediakan oleh konektor untuk aplikasi yang Anda buat.
    • Rahasia Klien: Secret Manager Secret yang berisi rahasia klien untuk aplikasi terhubung yang Anda buat.
  • Nama pengguna dan sandi
    • UserId: ID Pengguna Marketo SOAP API.
    • EncryptionKey: Secret Secret Manager yang berisi Kunci Enkripsi Marketo SOAP API.

Batasan sistem

Konektor Marketo dapat memproses 1 transaksi per detik, per node, dan mencegah transaksi apa pun melampaui batas ini. Secara default, Konektor Integrasi mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Konektor Integrasi, lihat Batas.

Menggunakan koneksi Marketo dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Integration Apigee dan Integration Aplikasi. 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.

Tindakan

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

Tindakan AddLandingPageContentSection

Menambahkan bagian konten ke halaman landing target.

Parameter input tindakan AddLandingPageContentSection

Nama Parameter Jenis Data Wajib Deskripsi
LandingPageId String Benar ID halaman landing
ContentId String Benar ID bagian konten. Juga ID HTML bagian.
Jenis String Benar Jenis bagian konten. Nilai yang diizinkan adalah Gambar, Formulir, Persegi Panjang, Cuplikan, RichText, HTML.

Misalnya, cara mengonfigurasi tindakan AddLandingPageContentSection, lihat Contoh tindakan.

Tindakan DeleteLandingPageContentSection

Menghapus bagian konten halaman landing di Marketo.

Parameter input tindakan DeleteLandingPageContentSection

Nama Parameter Jenis Data Wajib Deskripsi
LandingPageId String Benar ID halaman landing.
ContentId String Benar ID bagian konten. Juga ID HTML bagian.

Misalnya, cara mengonfigurasi tindakan DeleteLandingPageContentSection, lihat Contoh tindakan.

Tindakan UpdateEmailContent

Memperbarui konten email.

Parameter input tindakan UpdateEmailContent

Nama Parameter Jenis Data Wajib Deskripsi
EmailId String Benar ID email.
FromEmail String Benar Alamat pengirim Email
FromName String Benar Nama pengirim Email
ReplyTo String Benar Alamat Balas-Ke Email
Subjek String Benar Baris Subjek Email

Misalnya, cara mengonfigurasi tindakan UpdateEmailContent, lihat Contoh tindakan.

Tindakan UpdateLandingPageContentSection

Tambahkan atau perbarui bagian konten halaman landing di Marketo.

Parameter input tindakan UpdateLandingPageContentSection

Nama Parameter Jenis Data Wajib Deskripsi
Jenis String Benar Bagian jenis konten.Nilai yang diizinkan adalah Gambar, Formulir, Persegi Panjang, Cuplikan, RichText, HTML.
Nilai String Benar Jenis bagian konten.
LandingPageId String Benar ID halaman landing.
ContentId String Benar ID bagian konten. Juga ID HTML bagian.

Misalnya, cara mengonfigurasi tindakan UpdateLandingPageContentSection, lihat Contoh tindakan.

Tindakan GetImportProgramMembersStatus

Mendapatkan status anggota program impor dari operasi file untuk Marketo.

Parameter input tindakan GetImportProgramMembersStatus

Nama Parameter Jenis Data Wajib Deskripsi
BatchId String Benar ID batch prospek impor.

Misalnya, cara mengonfigurasi tindakan GetImportProgramMembersStatus, lihat Contoh tindakan.

Tindakan ScheduleCampaign

Menjadwalkan kampanye batch dari jarak jauh untuk dijalankan pada waktu tertentu.

Parameter input tindakan ScheduleCampaign

Nama Parameter Jenis Data Wajib Deskripsi
CampaignId String Benar ID kampanye batch yang akan dijadwalkan.
RunAt String Benar Waktu untuk menjalankan kampanye. Jika tidak ditetapkan, kampanye akan dijalankan lima menit setelah panggilan dilakukan.

Misalnya, cara mengonfigurasi tindakan ScheduleCampaign, lihat Contoh tindakan.

Tindakan ListMembersOfList

Menentukan apakah prospek terdapat dalam daftar di Marketo.

Parameter input tindakan ListMembersOfList

Nama Parameter Jenis Data Wajib Deskripsi
ListId String Benar ID daftar untuk memeriksa prospek.
LeadId String Benar Daftar ID prospek yang dipisahkan koma yang akan diperiksa apakah ada dalam daftar yang ditentukan oleh ListId.

Misalnya, cara mengonfigurasi tindakan ListMembersOfList, lihat Contoh tindakan.

Tindakan AssociateLead

Mengaitkan data prospek Marketo yang diketahui ke cookie munchkin dan histori aktivitas web terkait

Parameter input tindakan AssociateLead

Nama Parameter Jenis Data Wajib Deskripsi
LeadId String Benar ID Prospek yang akan dikaitkan.
Cookie String Benar Nilai cookie yang akan dikaitkan

Misalnya, cara mengonfigurasi tindakan AssociateLead, lihat Contoh tindakan.

Tindakan MergeLeads

Menggabungkan dua atau beberapa kumpulan data prospek yang diketahui menjadi satu kumpulan data prospek.

Parameter input tindakan MergeLeads

Nama Parameter Jenis Data Wajib Deskripsi
WinningLeadId String Benar ID data prospek pemenang
LoosingLeadId String Benar Daftar ID prospek yang hilang yang dipisahkan koma

Misalnya, cara mengonfigurasi tindakan MergeLeads, lihat Contoh tindakan.

Tindakan GetImportLeadsStatus

Mendapatkan status prospek impor dari operasi file untuk Marketo.

Parameter input tindakan GetImportLeadsStatus

Nama Parameter Jenis Data Wajib Deskripsi
BatchId String Benar ID batch prospek impor.

Misalnya, cara mengonfigurasi tindakan GetImportLeadsStatus, lihat Contoh tindakan.

Tindakan CancelExportJob

Membatalkan tugas ekspor.

Parameter input tindakan CancelExportJob

Nama Parameter Jenis Data Wajib Deskripsi
JobId String Benar ID tugas ekspor.
Jenis String Benar Jenis objek BulkExtract. Nilai yang tersedia adalah : Activities, Leads, ProgramMembers Nilai yang diizinkan adalah Activities, Leads, ProgramMembers.

Misalnya, cara mengonfigurasi tindakan CancelExportJob, lihat Contoh tindakan.

Tindakan EnqueueExportJob

Menempatkan tugas ekspor dalam antrean dan memulai tugas saat resource komputasi tersedia.

Parameter input tindakan EnqueueExportJob

Nama Parameter Jenis Data Wajib Deskripsi
JobId String Benar ID tugas ekspor.
Jenis String Benar Jenis objek BulkExtract. Nilai yang tersedia adalah : Activities, Leads, ProgramMembers. Nilai yang diizinkan adalah Activities, Leads, ProgramMembers.

Misalnya, cara mengonfigurasi tindakan EnqueueExportJob, lihat Contoh tindakan.

Tindakan GetExportJobStatus

Menampilkan status tugas ekspor. Status tugas tersedia selama 30 hari setelah status Selesai atau Gagal tercapai.

Parameter input tindakan GetExportJobStatus

Nama Parameter Jenis Data Wajib Deskripsi
JobId String Benar ID tugas ekspor.
Jenis String Benar Jenis objek BulkExtract. Nilai yang tersedia adalah : Activities, Leads, ProgramMembers. Nilai yang diizinkan adalah Activities, Leads, ProgramMembers.

Misalnya, cara mengonfigurasi tindakan GetExportJobStatus, lihat Contoh tindakan.

Tindakan CreateEmailTemplate

Membuat template email baru.

Parameter input tindakan CreateEmailTemplate

Nama Parameter Jenis Data Wajib Deskripsi
FolderId String Benar ID folder
FolderType String Benar Jenis folder.
Nama String Benar Nama Template Email. Harus unik di folder induk.
File String Benar File Multibagian. Konten HTML untuk template.

Misalnya, cara mengonfigurasi tindakan CreateEmailTemplate, lihat Contoh tindakan.

Tindakan UpdateLeadProgramStatus

Mengubah status program dari daftar prospek dalam program target. Hanya anggota program yang sudah ada yang statusnya dapat diubah dengan API ini.

Parameter input tindakan UpdateLeadProgramStatus

Nama Parameter Jenis Data Wajib Deskripsi
ProgramId String Benar ID kampanye batch yang akan dijadwalkan.
LeadIds String Benar Daftar ID prospek yang dipisahkan koma untuk input.
Status String Benar Status program data.

Misalnya, cara mengonfigurasi tindakan UpdateLeadProgramStatus, lihat Contoh tindakan.

Tindakan RemoveLeadsFromList

Menghapus prospek dari daftar di Marketo.

Parameter input tindakan RemoveLeadsFromList

Nama Parameter Jenis Data Wajib Deskripsi
ListId String Benar ID daftar yang akan menghapus prospek.
LeadId String Benar Daftar ID prospek yang dipisahkan koma yang akan dihapus dari daftar yang ditentukan oleh ListId.

Misalnya, cara mengonfigurasi tindakan RemoveLeadsFromList, lihat Contoh tindakan.

Tindakan ImportCustomObjectsFromFile

Mengimpor objek kustom dari file ke Marketo.

Parameter input tindakan ImportCustomObjectsFromFile

Nama Parameter Jenis Data Wajib Deskripsi
File String Benar Jalur ke file yang berisi objek kustom yang akan diimpor ke Marketo, yaitu 'C:\temp\custom_object_import.csv'.
TableName String Benar Nama tabel objek kustom. Contoh: CustomObject_test
Format String Benar Format file yang akan digunakan untuk mengimpor objek kustom ke Marketo. Nilai yang diizinkan adalah csv, tsv, ssv.
Konten String Benar Konten sebagai InputStream yang akan diupload jika File tidak ditentukan.

Misalnya, cara mengonfigurasi tindakan ImportCustomObjectsFromFile, lihat Contoh tindakan.

Contoh tindakan

Bagian ini menjelaskan cara melakukan beberapa tindakan di konektor ini.

Contoh - AddLandingPageContentSection

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan AddLandingPageContentSection , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1120",
  "Type": "HTML"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CampaignTest akan memiliki nilai yang mirip dengan berikut:

     
[{
  "Id": "1130",
  "json:repeatelementorder": "id",
  "requestsuccess": "true",
  "@affectedrows": "1"
}]

Contoh - DeleteLandingPageContentSection

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan DeleteLandingPageContentSection, lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "LandingPageId": "1005",
  "ContentId": "1009"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DeleteLandingPageContentSection akan memiliki nilai yang mirip dengan berikut:

     
[{
  "Id": "1005",
  "json:repeatelementorder": "id",
  "requestsuccess": "true",
  "@affectedrows": "1"
}]

Contoh - UpdateEmailContent

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan UpdateEmailContent , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
     {
  "EmailId": "1001",
  "FromName": "test",
  "FromEmail": "222larabrown@gmail.com",
  "Subject": "TestSubject Line",
  "ReplyTo": "222larabrown@gmail.com"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UpdateEmailContent akan memiliki nilai yang mirip dengan berikut:

     
[{
  "Id": "1001",
  "json:repeatelementorder": "id",
  "requestsuccess": "true"
}]

Contoh - UpdateLandingPageContentSection

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan UpdateLandingPageContentSection , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "Type": "HTML",
  "Value": "
Test Update
",
  "LandingPageId": "1005",
  "ContentId": "1120"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UpdateLandingPageContentSection akan memiliki nilai yang mirip dengan berikut:

     
[{
  "Id": "1005",
  "json:repeatelementorder": "id",
  "requestsuccess": "true",
  "@affectedrows": "1"
}]

Contoh - GetImportProgramMembersStatus

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan GetImportProgramMembersStatus , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "BatchId": "1029"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas GetImportProgramMembersStatus akan memiliki nilai yang mirip dengan berikut:

     
[{
  "BatchId": "1029",
  "Status": "Complete",
  "NumOfLeadsProcessed": "3",
  "NumOfRowsFailed": "0",
  "NumOfRowsWithWarning": "3",
  "Message": "Import succeeded, 3 records imported (3 members), 3 warning.",
  "importid": "1029",
  "requestsuccess": "true"
}]

Contoh - ScheduleCampaign

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan ScheduleCampaign , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "CampaignId": "1065",
  "RunAt": "2024-05-23T18:05:00+0000"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ScheduleCampaign akan memiliki nilai yang mirip dengan berikut:

     
[{
  "Success": "true",
  "id": "1065",
  "json:repeatelementorder": "id",
  "requestsuccess": "true"
}]

Contoh - ListMembersOfList

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan ListMembersOfList , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "ListId": "1003",
  "LeadId": "13,25,21"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ListMembersOfList akan memiliki nilai yang mirip dengan berikut:

     
[{
  "LeadId": "13",
  "Status": "notmemberof",
  "ReasonCode": null,
  "ReasonMessage": null,
  "id": "13",
  "requestsuccess": "true"
}, {
  "LeadId": "25",
  "Status": "notmemberof",
  "ReasonCode": null,
  "ReasonMessage": null,
  "id": "25",
  "requestsuccess": "true"
}, {
  "LeadId": "21",
  "Status": "notmemberof",
  "ReasonCode": null,
  "ReasonMessage": null,
  "id": "21",
  "requestsuccess": "true"
}]

Contoh - AssociateLead

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan AssociateLead , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "LeadId": 582.0,
  "Cookie": "id:703-VQQ-088%26token:_mch-marketo.com-_mch-mktoweb.com-1717156982039-98850"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas AssociateLead akan memiliki nilai yang mirip dengan berikut:

     
 [{
  "Status": "Success"
}]

Contoh - MergeLeads

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan MergeLeads , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
     {
  "LoosingLeadId": "10",
  "WinningLeadId": "45"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas MergeLeads akan memiliki nilai yang mirip dengan berikut:

     
  [{
  "Status": "Success"
}]

Contoh - GetImportLeadsStatus

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan GetImportLeadsStatus , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "BatchId": "1022"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas GetImportLeadsStatus akan memiliki nilai yang mirip dengan berikut:

     
 [{
  "BatchId": "1022",
  "Status": "Complete",
  "NumOfLeadsProcessed": "3",
  "NumOfRowsFailed": "0",
  "NumOfRowsWithWarning": "0",
  "Message": "Import succeeded, 3 records imported (3 members)",
  "importid": "1022",
  "requestsuccess": "true"
}]

Contoh - Membatalkan tugas ekspor

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan CancelExportJob , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "Type": "Leads"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CancelExportJob akan memiliki nilai yang mirip dengan berikut:

     
[{
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "JobStatus": "Cancelled",
  "Format": "CSV",
  "CreatedAt": "2024-05-28T05:45:13Z",
  "StartedAt": null,
  "QueuedAt": null,
  "exportid": null,
  "json:repeatelementorder": null,
  "status": null,
  "requestsuccess": null
}]

Contoh - EnqueueExportJob

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan EnqueueExportJob , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "Type": "Leads"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas EnqueueExportJob akan memiliki nilai yang mirip dengan berikut:

     
[{
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "JobStatus": "Queued",
  "Format": "CSV",
  "CreatedAt": "2024-05-27T12:12:53Z",
  "QueuedAt": "2024-05-27T12:13:20Z",
  "exportid": null,
  "json:repeatelementorder": null,
  "status": null,
  "requestsuccess": null
}]

Contoh - GetExportJobStatus

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan GetExportJobStatus , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas GetExportJobStatus akan memiliki nilai yang mirip dengan berikut:

     
[{
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Format": "CSV",
  "CreatedAt": "2024-05-23T10:12:09Z",
  "JobStatus": "Created",
  "QueuedAt": null,
  "StartedAt": null,
  "FinishedAt": null,
  "NumberOfRecords": null,
  "FileSize": null,
  "exportid": null,
  "status": null,
  "requestsuccess": null
}]

Contoh - CreateEmailTemplate

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan CreateEmailTemplate , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "FolderId": 27.0,
  "FolderType": "Folder",
  "Content": "\n\n\n \n
My First Heading
\n
My first paragraph.

\n \n\n",
  "Name": "Test1718166502676",
  "Filename": "FileName1718166502678"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CreateEmailTemplate akan memiliki nilai yang mirip dengan berikut:

     
[{
  "Id": "1048",
  "createdat": "2024-06-12T04:28:23Z+0000",
  "folder_type": "Folder",
  "workspace": "Default",
  "folder_foldername": "Templates",
  "name": "Test1718166502676",
  "version": "2",
  "requestsuccess": "true",
  "url": "https://app-abc.marketo.com/#ET1048B2ZN27",
  "folder_value": "27",
  "updatedat": "2024-06-12T04:28:23Z+0000",
  "status": "draft"
}]

Contoh - UpdateLeadProgramStatus

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan UpdateLeadProgramStatus , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "ProgramId": "1002",
  "Status": "Member",
  "LeadIds": "3"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UpdateLeadProgramStatus akan memiliki nilai yang mirip dengan berikut:

     
[{
  "Success": "true",
  "id": "3",
  "status": "updated",
  "requestsuccess": "true"
}]

Contoh - RemoveLeadsFromList

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan RemoveLeadsFromList , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
     {
  "ListId": "1026",
  "LeadId": "57"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas RemoveLeadsFromList akan memiliki nilai yang mirip dengan berikut:

     
[{
  "LeadId": "57",
  "Status": "skipped",
  "ReasonCode": "1015",
  "ReasonMessage": "Lead not in list",
  "id": "57",
  "requestsuccess": "true"
}]

Contoh - ImportCustomObjectsFromFile

  1. Pada dialog Configure connector task, klik Actions.
  2. Pilih tindakan ImportCustomObjectsFromFile , lalu klik Selesai.
  3. Di bagian Pemetaan Data, Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input: 
    {
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}

    4. Contoh ini menunjukkan data Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ImportCustomObjectsFromFile akan memiliki nilai yang mirip dengan berikut:

     
[{
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Format": "CSV",
  "CreatedAt": "2024-05-23T10:12:09Z",
  "JobStatus": "Created",
  "QueuedAt": null,
  "StartedAt": null,
  "FinishedAt": null,
  "NumberOfRecords": null,
  "FileSize": null,
  "exportid": null,
  "status": null,
  "requestsuccess": null
}]

Contoh operasi entity

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

Saat menggunakan operasi daftar dan memperkirakan volume data akan tinggi, sebaiknya tentukan klausa filter untuk entity berikut: LeadsLists, LeadPrograms, Activities, LandingPageContentSec, LeadChanges, LeadChangesFields, Emails, LandingPages, Forms, Programs, Leads, LandingPageTemplateCon, OpportunityRoles, SalesPersons, Tokens, ListStaticMemberShip, Opportunities, LeadChangesAttributes, dan Segments. Selain itu, untuk mengurutkan kumpulan hasil, Anda harus menerapkan klausa filter terlebih dahulu.

Contoh - Mencantumkan semua Email

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih Email dari daftar Entity.
  3. Pilih operasi List, lalu klik Selesai.

Contoh - Mendapatkan satu SmartCampaigns

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih SmartCampaigns dari daftar Entity.
  3. Pilih operasi Get, lalu klik Done.
  4. Tetapkan ID entitas ke Get single SmartCampaigns. Untuk menetapkan ID entitas, di bagian Data Mapper pada Data Mapping, klik Open Data Mapping Editor, lalu masukkan 1002 di kolom Input Value dan pilih EntityId sebagai variabel Lokal.

Contoh - Menghapus Email

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih Email dari daftar Entity.
  3. Pilih operasi Delete, lalu klik Selesai.
  4. Tetapkan ID entitas ke Delete Emails. Untuk menetapkan ID entitas, di bagian Data Mapper pada Data Mapping, klik Open Data Mapping Editor, lalu masukkan 1048.0 di kolom Input Value dan pilih EntityId sebagai variabel Lokal.

Contoh - Membuat Email

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih Email dari daftar Entity.
  3. Pilih operasi Create, lalu klik Selesai.
  4. Di bagian Pemetaan data pada Tugas, klik OpenDataMapping editor, lalu masukkan nilai yang mirip dengan berikut di field: 
     {
"Template": 1.0,
"FolderId": 1002.0,
"Name": "Test Email",
"FolderType": "Program"
}

    Running this example, returns a response similar to the following in the Connector
task's connectorOutputPayload output variable:
    

    {
"Id": "1048.0"
}

Contoh - Memperbarui EmailTemplates

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih EmailTemplates dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Tetapkan EntityID untuk Memperbarui EmailTemplates. Untuk menetapkan EntityID, di bagian Data mapper pada Tasks, klik EntityID, lalu masukkan 1034.0 di kolom yang ditentukan.
  5. Di bagian Pemetaan data pada Tugas, klik OpenDataMapping editor, lalu masukkan nilai yang mirip dengan berikut di field: 
     
{
"Name": "temp email updated",
"Description": "updation"
}

    6. Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut ini di variabel output connectorOutputPayload tugas Konektor:

    {
"Id": 1034.0
}

Mendapatkan bantuan dari komunitas Google Cloud

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

Langkah berikutnya