Mulai

Dengan Manufacturer Center (MfC) API, aplikasi dapat 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 bisa mulai melakukan coding, ada beberapa hal yang perlu Anda lakukan.

Dukungan REST

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

Bagian lainnya dalam dokumentasi ini akan ditulis terutama untuk Product, tetapi prosesnya harus mirip dengan ProductCertification.

Siapkan Akun Manufacturer Center Anda

  1. Buat Akun Manufacturer Center.

  2. Pastikan untuk mengingat email 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.

Membuat permintaan API pertama Anda (tanpa baris kode!)

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

  2. Pastikan akun Google yang login tercantum di setelan 'Pengguna' di tab Setelan.

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

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

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

  6. Jika Anda belum memiliki produk di Manufacturer Center, tidak akan ada produk apa pun dalam daftar. Pada tahap ini, Anda dapat melompat ke permintaan lain dan melihat apa yang dilakukannya. Karena ini adalah RESTful API, semua permintaan berfungsi dengan cara yang sama. Setelah memiliki produk, langkah selanjutnya 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 pertama Anda yang diotorisasi menggunakan Java

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

  1. Instal Apache Maven, jika Anda belum melakukannya.

  2. Download contoh Shopping dari halaman GitHub kami.

  3. Dari dalam subdirektori java, buat contoh Java:

    $ mvn compile

  4. Sekarang, jalankan kode ProductsListSample (contoh untuk ProductCertification 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 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 untuk memberi tahu kode lokasi file Anda dengan menyetel variabel lingkungan berikut.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. Setelah menyiapkan konfigurasi contoh, jalankan kode ProductsListSample lagi.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. Pada tahap ini, program Java akan selesai dieksekusi, dan mencetak daftar produk yang ditemukannya, atau pesan bahwa tidak ada produk di akun Anda. Jika Anda mendapatkan pesan error, seperti "Pengguna tidak dapat mengakses akun 1234567890", kemungkinan besar karena Anda belum menyiapkan pengguna akun layanan sebagai pengguna yang diberi otorisasi di Manufacturer Center. Dari sudut pandang API, project Konsol API mengirim permintaan atas nama pengguna yang tidak ada dalam daftar administrator Manufacturer Center resmi, sehingga pasti akan menolak permintaan tersebut.

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