เริ่มต้นใช้งาน

Manufacturer Center (MfC) API ช่วยให้แอปโต้ตอบกับแพลตฟอร์ม Manufacturer Center ได้โดยตรง เรามีตัวอย่างโค้ดใน Java และ .NET เพื่อช่วยคุณเริ่มต้นใช้งาน

คู่มือนี้จะช่วยคุณสร้างแอปพลิเคชันแรกโดยใช้ Manufacturer Center API ก่อนที่คุณจะเริ่มต้นเขียนโค้ดได้ คุณต้องดำเนินการบางอย่าง

การสนับสนุน REST

API ของ REST ของเรารองรับการดำเนินการ CRUD พื้นฐานสำหรับทรัพยากร 2 ประเภท ดังนี้

• ผลิตภัณฑ์สำหรับเจ้าของแบรนด์และพาร์ทเนอร์ด้านข้อมูล
• และ ProductCertification สำหรับหน่วยงานการรับรอง

ส่วนที่เหลือของเอกสารประกอบนี้จะเขียนไว้สำหรับ Product เป็นหลัก แต่กระบวนการควรจะคล้ายคลึงกันสำหรับ ProductCertification

ตั้งค่าบัญชี Manufacturer Center

1. สร้างบัญชี Manufacturer Center

2. อย่าลืมจดจำอีเมลที่ใช้สร้างบัญชี Manufacturer Center นี้ เนื่องจากคุณจะต้องใช้ในภายหลัง ในภาพหน้าจอ คุณจะเห็นรหัสดังกล่าว เป็น manufacturer_user@example.com

สร้างคำขอ API แรกของคุณ (โดยไม่ต้องเขียนโค้ด!)

1. ไปที่โปรแกรมสำรวจ API ในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Accounts.Products.list

2. ตรวจสอบว่าบัญชี Google ที่เข้าสู่ระบบแสดงอยู่ในการตั้งค่า "ผู้ใช้" ในแท็บการตั้งค่า

   

3. ใน API Explorer ให้ตรวจดูว่าได้เลือก Google OAuth 2.0 ไว้ในเมนูแบบเลื่อนลงการตรวจสอบสิทธิ์แล้ว

   

4. ป้อน accounts/{account_id} โดยแทนที่ {account_id} ด้วยรหัสผู้ผลิตจากบัญชี Manufacturer Center ลงในช่อง "หลัก" ของแบบฟอร์ม แล้วคลิกดำเนินการ

   

5. คุณควรจะเห็นการตอบกลับที่สำเร็จ ยินดีด้วย คุณได้ส่งคำขอ Manufacturer Center API ครั้งแรกแล้ว

6. หากยังไม่มีผลิตภัณฑ์ใน Manufacturer Center จะไม่มีผลิตภัณฑ์ในรายการ ที่จุดนี้ คุณสามารถข้ามไปยังคำขออื่นๆ และดูว่า คำขอเหล่านั้นทำอะไรได้บ้าง เนื่องจากนี่คือ RESTful API คำขอทั้งหมดจึงทำงานคล้ายกัน ขั้นตอนถัดไปที่ดีเมื่อคุณมีผลิตภัณฑ์แล้วก็คือการลองใช้ Accounts.Products.get

สร้างโปรเจ็กต์คอนโซล Google API

คำขอที่ส่งไปยัง Manufacturer Center API จะดำเนินการผ่านโปรเจ็กต์คอนโซล API ของคุณ เราจะถือว่าคุณจะเข้าถึงบัญชี Manufacturer Center ของคุณเอง ดังนั้นเราขอแนะนำให้ใช้บัญชีบริการเพื่อให้ขั้นตอนการตรวจสอบสิทธิ์ง่ายขึ้น โปรดดูรายละเอียดวิธีตั้งค่าบัญชีบริการใหม่เพื่อใช้กับบัญชี Manufacturer Center ในคำแนะนำบัญชีบริการ

คำขอ API แรกที่ได้รับอนุญาตซึ่งใช้ Java

ตอนนี้เมื่อตั้งค่าบัญชีบริการและเพิ่มรหัสบัญชีบริการลงในบัญชี Manufacturer Center แล้ว คุณจะเข้าถึงบัญชีได้โดยใช้โค้ดตัวอย่างที่มีอยู่ คู่มือนี้ใช้ตัวอย่าง Java เพื่อสาธิตการใช้ API

1. ติดตั้ง Apache Maven หากยังไม่ได้ติดตั้ง

2. ดาวน์โหลดตัวอย่าง Shopping จากหน้า GitHub ของเรา

3. จากในไดเรกทอรีย่อย java ให้สร้างตัวอย่าง Java ดังนี้

   $ mvn compile
   

4. ต่อไปให้เรียกใช้โค้ด ProductsListSample (ตัวอย่างสำหรับ ProductCertification คือ ListProductCertificationsSample) ดังนี้

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

5. หากไม่ปฏิบัติตามคำแนะนำการกำหนดค่าใน README ที่มาพร้อมกับไฟล์ต้นฉบับ คุณจะได้รับข้อผิดพลาดว่าไม่พบตัวอย่างการกำหนดค่า ทำตามคำแนะนำใน README เพื่อสร้างไดเรกทอรีการกำหนดค่าและป้อนข้อมูลที่เหมาะสม คุณควรวางไฟล์ JSON ที่คุณดาวน์โหลดขณะตั้งค่าบัญชีบริการไว้ในไดเรกทอรีดังกล่าวด้วยชื่อไฟล์ service-account.json อย่าลืมบอกโค้ดว่าไฟล์อยู่ที่ไหนโดยการตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้

   export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
   

6. เมื่อตั้งค่าตัวอย่างแล้ว ให้เรียกใช้โค้ด ProductsListSample อีกครั้ง

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

7. เมื่อถึงจุดนี้ โปรแกรม Java ควรจะทำงานให้เสร็จสิ้น และพิมพ์รายการผลิตภัณฑ์ที่พบหรือข้อความว่าไม่มีผลิตภัณฑ์ในบัญชีของคุณ หากได้รับข้อผิดพลาด เช่น "ผู้ใช้เข้าถึงบัญชี 1234567890 ไม่ได้" อาจเป็นเพราะคุณยังไม่ได้ตั้งค่าผู้ใช้บัญชีบริการเป็นผู้ใช้ที่ได้รับอนุญาตใน Manufacturer Center จากมุมมองของ API นั้น โปรเจ็กต์คอนโซล API ส่งคำขอในนามของผู้ใช้ที่ไม่ได้อยู่ในรายชื่อผู้ดูแลระบบ Manufacturer Center ที่ได้รับอนุญาต ดังนั้นระบบจึงจะปฏิเสธคำขอดังกล่าว

8. คุณสามารถทดสอบการเรียกใช้ ProductsListSample กี่ครั้งก็ได้ตามที่ต้องการ เนื่องจากเป็นคำขอแบบอ่านอย่างเดียว คุณสำรวจตัวอย่างอื่นๆ ที่เราสร้างไว้สำหรับทั้ง Java และ .NET ได้ด้วย