Mulai

Dengan Manufacturer Center API, aplikasi dapat berinteraksi langsung dengan platform Manufacturer Center. Untuk membantu Anda memulai, kami menawarkan contoh kode dalam Java dan .NET.

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

Menyiapkan Akun Manufacturer Center

  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 ditampilkan sebagai manufacturer_user@example.com.

Buat permintaan API pertama Anda (tanpa baris kode!)

  1. Buka APIs Explorer di dokumentasi developer kami untuk Accounts.Products.list.
  2. Pastikan bahwa akun Google yang digunakan untuk login tercantum di setelan 'Pengguna' pada tab Setelan.

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

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

    Catatan: Jika sebelumnya Anda tidak memberikan izin OAuth2, Anda kini akan diminta untuk mengizinkan panggilan.

  5. Anda akan melihat respons yang berhasil. Selamat! Anda telah membuat permintaan Manufacturer Center API pertama Anda.
  6. Jika Anda belum memiliki produk di Manufacturer Center, tidak akan ada produk dalam daftar. Pada tahap ini, Anda dapat beralih ke permintaan lain dan melihat tindakannya. Karena ini adalah RESTful API, semua permintaan akan berfungsi serupa. Langkah selanjutnya yang baik, 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.

Catatan: Jika Anda tertarik untuk melakukan panggilan atas nama klien dengan akun Manufacturer Center mereka sendiri, lihat panduan Mengotorisasi Permintaan.

Permintaan API resmi Anda yang pertama 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 menggunakan API.

  1. Instal Apache Maven, jika Anda belum memilikinya.
  2. Download sampel Shopping dari halaman GitHub kami.

  3. Dari dalam subdirektori java, buat contoh Java:

    $ mvn compile
            

  4. Sekarang jalankan kode ProductsListSample:

    $ 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 menerima 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.

  6. Setelah Anda 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 mengeksekusi, dan mencetak daftar produk yang ditemukan, atau pesan bahwa tidak ada produk di akun Anda. Jika Anda mendapatkan pesan error seperti "Pengguna tidak dapat mengakses akun 1234567890" kemungkinan besar itu 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 ada dalam daftar administrator Manufacturer Center yang berwenang, sehingga tentu saja akan menolak permintaan tersebut.

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