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 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. Konektor dan akun layanan harus berada dalam project yang sama. 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.

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:

  1. Di Konsol Cloud, buka halaman Integration Connectors > Connections 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 Detail Koneksi, selesaikan langkah-langkah berikut:
    1. Konektor: Pilih Marketo 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. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
    6. 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.

    7. Atau, 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 mengetahui informasi tentang cara mengonfigurasi Private Service Connect, lihat Memublikasikan layanan terkelola.

      Berdasarkan pilihan jenis tujuan Anda, 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 diberikan 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 Manager Secret yang berisi Kunci Enkripsi Marketo SOAP API.

Batasan sistem

Konektor Marketo dapat memproses 1 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.

Menggunakan koneksi Marketo dalam integrasi

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

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

Untuk contoh 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.

Untuk contoh 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

Untuk contoh 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 Image, Form, Rectangle, Snippet, RichText, HTML.
Nilai String Benar Jenis bagian konten.
LandingPageId String Benar ID halaman landing.
ContentId String Benar ID bagian konten. Juga ID HTML bagian.

Untuk contoh cara mengonfigurasi tindakan UpdateLandingPageContentSection, lihat Contoh tindakan.

Tindakan GetImportProgramMembersStatus

Mendapatkan status operasi impor anggota program dari file untuk Marketo.

Parameter input tindakan GetImportProgramMembersStatus

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

Untuk contoh 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 Tanggal dan waktu untuk menjalankan kampanye. Jika tidak disetel, kampanye akan dijalankan lima menit setelah panggilan dilakukan.

Untuk contoh cara mengonfigurasi tindakan ScheduleCampaign, lihat Contoh tindakan.

Tindakan ListMembersOfList

Menentukan apakah prospek ada 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 untuk diperiksa apakah ada dalam daftar yang ditentukan oleh ListId.

Untuk contoh cara mengonfigurasi tindakan ListMembersOfList, lihat Contoh tindakan.

Tindakan AssociateLead

Mengaitkan rekaman prospek Marketo yang diketahui dengan 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

Untuk contoh cara mengonfigurasi tindakan AssociateLead, lihat Contoh tindakan.

Tindakan MergeLeads

Menggabungkan dua data prospek atau lebih yang diketahui ke dalam satu data prospek.

Parameter input tindakan MergeLeads

Nama Parameter Jenis Data Wajib Deskripsi
WinningLeadId String Benar ID rekaman prospek yang menang
LoosingLeadId String Benar Daftar ID prospek yang dipisahkan koma

Untuk contoh cara mengonfigurasi tindakan MergeLeads, lihat Contoh tindakan.

Tindakan GetImportLeadsStatus

Mendapatkan status operasi impor prospek dari file untuk Marketo.

Parameter input tindakan GetImportLeadsStatus

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

Untuk contoh 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.

Untuk contoh 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.

Untuk contoh 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.

Untuk contoh 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 bawah folder induk.
File String Benar File Multibagian. Konten HTML untuk template.

Untuk contoh 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 dapat diubah statusnya 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 rekaman.

Untuk contoh 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 dihapus prospeknya.
LeadId String Benar Daftar ID prospek yang dipisahkan koma yang akan dihapus dari daftar yang ditentukan oleh ListId.

Untuk contoh 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.

Untuk contoh cara mengonfigurasi tindakan ImportCustomObjectsFromFile, lihat Contoh tindakan.

Contoh tindakan

Bagian ini menjelaskan cara melakukan beberapa tindakan di konektor ini.

Contoh - AddLandingPageContentSection

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CampaignTest akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - DeleteLandingPageContentSection

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DeleteLandingPageContentSection akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - UpdateEmailContent

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UpdateEmailContent akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - UpdateLandingPageContentSection

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UpdateLandingPageContentSection akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - GetImportProgramMembersStatus

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas GetImportProgramMembersStatus akan memiliki nilai yang mirip dengan berikut ini:

     
[{
  "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. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ScheduleCampaign akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - ListMembersOfList

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ListMembersOfList akan memiliki nilai yang mirip dengan berikut ini:

     
[{
  "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. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas AssociateLead akan memiliki nilai yang mirip dengan berikut ini:

     
 [{
  "Status": "Success"
}]

Contoh - MergeLeads

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas MergeLeads akan memiliki nilai yang mirip dengan berikut ini:

     
  [{
  "Status": "Success"
}]

Contoh - GetImportLeadsStatus

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas GetImportLeadsStatus akan memiliki nilai yang mirip dengan berikut ini:

     
 [{
  "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. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CancelExportJob akan memiliki nilai yang mirip dengan berikut ini:

     
[{
  "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. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas EnqueueExportJob akan memiliki nilai yang mirip dengan berikut ini:

     
[{
  "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. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas GetExportJobStatus akan memiliki nilai yang mirip dengan berikut ini:

     
[{
  "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. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CreateEmailTemplate akan memiliki nilai yang mirip dengan berikut ini:

     
[{
  "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. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UpdateLeadProgramStatus akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - RemoveLeadsFromList

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas RemoveLeadsFromList akan memiliki nilai yang mirip dengan berikut ini:

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

Contoh - ImportCustomObjectsFromFile

  1. Dalam 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 catatan Objek tertentu. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ImportCustomObjectsFromFile akan memiliki nilai yang mirip dengan berikut ini:

     
[{
  "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 entitas di konektor ini.

Saat Anda 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. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Email dari daftar Entity.
  3. Pilih operasi List, lalu klik Selesai.

Contoh - Mendapatkan satu SmartCampaigns

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih SmartCampaigns dari daftar Entity.
  3. Pilih operasi Get, lalu klik Selesai.
  4. Tetapkan ID entitas ke Get single SmartCampaigns. Untuk menyetel ID entitas, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan 1002 di kolom Nilai Input dan pilih EntityId sebagai Variabel lokal.

Contoh - Menghapus Email

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Email dari daftar Entity.
  3. Pilih operasi Delete, lalu klik Selesai.
  4. Setel ID entitas ke Hapus Email. Untuk menyetel ID entitas, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan 1048.0 di kolom Nilai Input dan pilih EntityId sebagai Variabel lokal.

Contoh - Membuat Email

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Email dari daftar Entity.
  3. Pilih operasi Create, lalu klik Selesai.
  4. Di bagian Pemeta data pada Tugas, klik editor OpenDataMapping, 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 - Update EmailTemplates

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih EmailTemplates dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Tetapkan EntityID ke Update a EmailTemplates. Untuk menyetel EntityID, di bagian Pemeta data pada Tugas, klik EntityID, lalu masukkan 1034.0 di kolom yang tersedia.
  5. Di bagian Pemeta data pada Tugas, klik editor OpenDataMapping, lalu masukkan nilai yang mirip dengan berikut di field: 
     
{
"Name": "temp email updated",
"Description": "updation"
}

    6. Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

    {
"Id": 1034.0
}

Mendapatkan bantuan dari komunitas Google Cloud

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

Langkah berikutnya