Mulai

Manufacturer Center API (MfC) memungkinkan aplikasi berinteraksi langsung dengan platform Manufacturer Center. Untuk membantu Anda memulai, kami menawarkan contoh kode di Java dan .NET.

Panduan ini akan membantu Anda membuat aplikasi pertama Anda menggunakan Manufacturer Center API. Sebelum Anda dapat memulai coding, ada beberapa hal yang perlu dilakukan.

Dukungan REST

REST API kami mendukung operasi CRUD dasar untuk 2 jenis resource berbeda:

Bagian selanjutnya dalam dokumentasi ini akan ditulis terutama untuk Product, tetapi prosesnya harus serupa untuk ProductSertifikasi.

Siapkan Akun Manufacturer Center Anda

  1. Buat Akun Manufacturer Center.

  2. Pastikan untuk mengingat email mana yang Anda gunakan untuk membuat akun Manufacturer Center ini, karena Anda akan memerlukannya nanti. Dalam screenshot, Anda akan melihatnya direpresentasikan sebagai manufacturer_user@example.com.

Buat permintaan API pertama Anda (tanpa sebaris kode!)

  1. Buka Penjelajah API dalam dokumentasi developer kami untuk Accounts.Products.list.

  2. Pastikan akun Google yang digunakan untuk login sudah tercantum dalam setelan 'Pengguna' di tab Setelan.

  3. Di APIs Explorer, pastikan Google OAuth 2.0 dipilih dalam menu drop-down Authentication:

  4. Masukkan accounts/{account_id}, ganti {account_id} dengan ID Manufacturer dari akun Manufacturer Center Anda, ke kolom 'induk' pada formulir, dan klik Jalankan.

  5. Anda akan melihat respons yang berhasil. Selamat! Anda berhasil membuat permintaan Manufacturer Center API pertama.

  6. Jika Anda belum memiliki produk di Manufacturer Center, tidak akan ada produk di daftar. Pada tahap ini, Anda dapat beralih ke permintaan lain dan melihat apa yang dilakukannya. Karena ini adalah RESTful API, semua permintaan akan berfungsi dengan cara yang sama. Langkah berikutnya, setelah Anda memiliki produk, adalah mencoba Accounts.Products.get.

Membuat Project Konsol API Google

Permintaan ke Manufacturer Center API dibuat melalui project Konsol API Anda. Di sini kami berasumsi bahwa Anda akan mengakses akun Manufacturer Center Anda sendiri, jadi sebaiknya gunakan akun layanan untuk menyederhanakan alur autentikasi. Lihat Panduan Akun Layanan untuk mengetahui detail tentang cara menyiapkan akun layanan baru untuk digunakan dengan akun Manufacturer Center Anda.

Permintaan API resmi pertama Anda menggunakan Java

Setelah menyiapkan akun layanan dan menambahkan ID akun layanan ke akun Manufacturer Center, Anda dapat mengakses akun tersebut menggunakan Kode contoh yang tersedia. Panduan ini menggunakan contoh Java untuk mendemonstrasikan penggunaan API.

  1. Instal Apache Maven, jika Anda belum melakukannya.

  2. Download sampel Shopping dari halaman GitHub.

  3. Dari dalam subdirektori java, buat contoh Java:

    $ mvn compile
    
  4. Sekarang jalankan kode ProductsListSample (contoh untuk ProductSertifikasi adalah ListProductCertificationsSample):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  5. Jika belum mengikuti petunjuk konfigurasi di README yang menyertai file sumber, Anda akan mendapatkan pesan error bahwa konfigurasi contoh tidak dapat ditemukan. Ikuti petunjuk di README untuk membuat direktori konfigurasi dan mengisinya dengan informasi yang sesuai. File JSON yang Anda download saat menyiapkan akun layanan harus ditempatkan di direktori tersebut dengan nama file service-account.json. Jangan lupa memberi tahu kode lokasi file Anda dengan menetapkan variabel lingkungan berikut.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
    
  6. Setelah Anda menyiapkan konfigurasi contoh, jalankan lagi kode ProductsListSample.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  7. Pada tahap ini, program Java akan selesai mengeksekusi dan mencetak daftar produk yang ditemukannya, atau pesan bahwa tidak ada produk di akun Anda. Jika Anda mendapatkan error seperti "Pengguna tidak dapat mengakses akun 1234567890", kemungkinan besar ini karena Anda belum menyiapkan pengguna akun layanan sebagai pengguna yang diotorisasi di Manufacturer Center. Dari sudut pandang API, project Konsol API mengirim permintaan atas nama pengguna yang tidak termasuk dalam daftar administrator Manufacturer Center yang diotorisasi, sehingga tentu saja akan menolak permintaan tersebut.

  8. Anda dapat bereksperimen dengan menjalankan ProductsListSample sebanyak yang Anda inginkan, karena ini adalah permintaan hanya baca. Anda juga dapat menjelajahi contoh lain yang telah kami buat untuk Java dan .NET.