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

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

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

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

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

สร้างคําขอ API แรก (โดยไม่ต้องใส่โค้ด)

  1. โปรดไปที่ API API Explorer ในเอกสารประกอบสําหรับนักพัฒนาซอฟต์แวร์ Accounts.Products.list
  2. ตรวจสอบว่าบัญชี Google ที่เข้าสู่ระบบแสดงอยู่ในการตั้งค่า 'ผู้ใช้' ในแท็บการตั้งค่า

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

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

    หมายเหตุ: หากคุณไม่ได้ให้สิทธิ์ OAuth2 มาก่อน ระบบจะขอให้คุณให้สิทธิ์การโทร

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

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

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

หมายเหตุ: หากสนใจโทรออกในนามของลูกค้าด้วยบัญชี Manufacturer Center ของตนเอง โปรดดูคู่มือให้สิทธิ์คําขอ

คําขอ API แรกที่ได้รับอนุญาตโดยใช้ Java

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

  1. ติดตั้ง Apache Maven หากยังไม่ได้ติดตั้ง
  2. ดาวน์โหลดตัวอย่าง Shopping จากหน้า GitHub

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

    $ mvn compile
            

  4. ตอนนี้เรียกใช้รหัส ProductsListSample ด้วย

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

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

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

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
            
  7. ณ จุดนี้ โปรแกรม Java ควรดําเนินการให้เสร็จสิ้น แล้วพิมพ์รายการผลิตภัณฑ์ที่พบ หรือข้อความที่แจ้งว่าไม่มีผลิตภัณฑ์อยู่ในบัญชี หากพบข้อผิดพลาด เช่น "User ไม่สามารถเข้าถึงบัญชี 1234567890" ได้ อาจเป็นเพราะคุณไม่ได้ตั้งค่าผู้ใช้บัญชีบริการเป็นผู้ใช้ที่ได้รับอนุญาตใน Manufacturer Center จาก API API#39 โปรเจ็กต์คอนโซล API ได้ส่งคําขอในนามของผู้ใช้ที่ไม่ได้อยู่ในรายชื่อผู้ดูแลระบบ Manufacturer Center ที่ได้รับอนุญาต ดังนั้นจะปฏิเสธคําขอดังกล่าว

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