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

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

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

การรองรับ REST

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

ส่วนที่เหลือของเอกสารประกอบนี้จะเขียนสําหรับผลิตภัณฑ์เป็นหลัก แต่กระบวนการนี้ควรเป็นไปตามการรับรองผลิตภัณฑ์

สร้างบัญชี 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 (ตัวอย่างการรับรองผลิตภัณฑ์จะเป็น 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 ได้ด้วย