Manufacturer Center (MfC) API ช่วยให้แอปโต้ตอบกับแพลตฟอร์ม Manufacturer Center ได้โดยตรง เรามีตัวอย่างโค้ดใน Java และ .NET เพื่อช่วยคุณเริ่มต้นใช้งาน
คู่มือนี้จะช่วยคุณสร้างแอปพลิเคชันแรกโดยใช้ Manufacturer Center API ก่อนที่คุณจะเริ่มต้นเขียนโค้ดได้ คุณต้องดำเนินการบางอย่าง
การสนับสนุน REST
API ของ REST ของเรารองรับการดำเนินการ CRUD พื้นฐานสำหรับทรัพยากร 2 ประเภท ดังนี้
- ผลิตภัณฑ์สำหรับเจ้าของแบรนด์และพาร์ทเนอร์ด้านข้อมูล
- และ ProductCertification สำหรับหน่วยงานการรับรอง
ส่วนที่เหลือของเอกสารประกอบนี้จะเขียนไว้สำหรับ Product เป็นหลัก แต่กระบวนการควรจะคล้ายคลึงกันสำหรับ ProductCertification
ตั้งค่าบัญชี Manufacturer Center
อย่าลืมจดจำอีเมลที่ใช้สร้างบัญชี Manufacturer Center นี้ เนื่องจากคุณจะต้องใช้ในภายหลัง ในภาพหน้าจอ คุณจะเห็นรหัสดังกล่าว เป็น manufacturer_user@example.com
สร้างคำขอ API แรกของคุณ (โดยไม่ต้องเขียนโค้ด!)
ไปที่โปรแกรมสำรวจ API ในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์
Accounts.Products.list
ตรวจสอบว่าบัญชี Google ที่เข้าสู่ระบบแสดงอยู่ในการตั้งค่า "ผู้ใช้" ในแท็บการตั้งค่า
ใน API Explorer ให้ตรวจดูว่าได้เลือก Google OAuth 2.0 ไว้ในเมนูแบบเลื่อนลงการตรวจสอบสิทธิ์แล้ว
ป้อน
accounts/{account_id}
โดยแทนที่{account_id}
ด้วยรหัสผู้ผลิตจากบัญชี Manufacturer Center ลงในช่อง "หลัก" ของแบบฟอร์ม แล้วคลิกดำเนินการคุณควรจะเห็นการตอบกลับที่สำเร็จ ยินดีด้วย คุณได้ส่งคำขอ Manufacturer Center API ครั้งแรกแล้ว
หากยังไม่มีผลิตภัณฑ์ใน Manufacturer Center จะไม่มีผลิตภัณฑ์ในรายการ ที่จุดนี้ คุณสามารถข้ามไปยังคำขออื่นๆ และดูว่า คำขอเหล่านั้นทำอะไรได้บ้าง เนื่องจากนี่คือ RESTful API คำขอทั้งหมดจึงทำงานคล้ายกัน ขั้นตอนถัดไปที่ดีเมื่อคุณมีผลิตภัณฑ์แล้วก็คือการลองใช้
Accounts.Products.get
สร้างโปรเจ็กต์คอนโซล Google API
คำขอที่ส่งไปยัง Manufacturer Center API จะดำเนินการผ่านโปรเจ็กต์คอนโซล API ของคุณ เราจะถือว่าคุณจะเข้าถึงบัญชี Manufacturer Center ของคุณเอง ดังนั้นเราขอแนะนำให้ใช้บัญชีบริการเพื่อให้ขั้นตอนการตรวจสอบสิทธิ์ง่ายขึ้น โปรดดูรายละเอียดวิธีตั้งค่าบัญชีบริการใหม่เพื่อใช้กับบัญชี Manufacturer Center ในคำแนะนำบัญชีบริการ
คำขอ API แรกที่ได้รับอนุญาตซึ่งใช้ Java
ตอนนี้เมื่อตั้งค่าบัญชีบริการและเพิ่มรหัสบัญชีบริการลงในบัญชี Manufacturer Center แล้ว คุณจะเข้าถึงบัญชีได้โดยใช้โค้ดตัวอย่างที่มีอยู่ คู่มือนี้ใช้ตัวอย่าง Java เพื่อสาธิตการใช้ API
ติดตั้ง Apache Maven หากยังไม่ได้ติดตั้ง
ดาวน์โหลดตัวอย่าง Shopping จากหน้า GitHub ของเรา
จากในไดเรกทอรีย่อย
java
ให้สร้างตัวอย่าง Java ดังนี้$ mvn compile
ต่อไปให้เรียกใช้โค้ด
ProductsListSample
(ตัวอย่างสำหรับ ProductCertification คือListProductCertificationsSample
) ดังนี้$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
หากไม่ปฏิบัติตามคำแนะนำการกำหนดค่าใน README ที่มาพร้อมกับไฟล์ต้นฉบับ คุณจะได้รับข้อผิดพลาดว่าไม่พบตัวอย่างการกำหนดค่า ทำตามคำแนะนำใน README เพื่อสร้างไดเรกทอรีการกำหนดค่าและป้อนข้อมูลที่เหมาะสม คุณควรวางไฟล์ JSON ที่คุณดาวน์โหลดขณะตั้งค่าบัญชีบริการไว้ในไดเรกทอรีดังกล่าวด้วยชื่อไฟล์
service-account.json
อย่าลืมบอกโค้ดว่าไฟล์อยู่ที่ไหนโดยการตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
เมื่อตั้งค่าตัวอย่างแล้ว ให้เรียกใช้โค้ด
ProductsListSample
อีกครั้ง$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
เมื่อถึงจุดนี้ โปรแกรม Java ควรจะทำงานให้เสร็จสิ้น และพิมพ์รายการผลิตภัณฑ์ที่พบหรือข้อความว่าไม่มีผลิตภัณฑ์ในบัญชีของคุณ หากได้รับข้อผิดพลาด เช่น "ผู้ใช้เข้าถึงบัญชี 1234567890 ไม่ได้" อาจเป็นเพราะคุณยังไม่ได้ตั้งค่าผู้ใช้บัญชีบริการเป็นผู้ใช้ที่ได้รับอนุญาตใน Manufacturer Center จากมุมมองของ API นั้น โปรเจ็กต์คอนโซล API ส่งคำขอในนามของผู้ใช้ที่ไม่ได้อยู่ในรายชื่อผู้ดูแลระบบ Manufacturer Center ที่ได้รับอนุญาต ดังนั้นระบบจึงจะปฏิเสธคำขอดังกล่าว
คุณสามารถทดสอบการเรียกใช้
ProductsListSample
กี่ครั้งก็ได้ตามที่ต้องการ เนื่องจากเป็นคำขอแบบอ่านอย่างเดียว คุณสำรวจตัวอย่างอื่นๆ ที่เราสร้างไว้สำหรับทั้ง Java และ .NET ได้ด้วย