คุณควรเข้าใจแนวคิดเรื่องการลงทะเบียน การตรวจสอบสิทธิ์ และการให้สิทธิ์ เพื่อให้ใช้ Merchant API ได้อย่างมีประสิทธิภาพ ซึ่งมีวัตถุประสงค์ที่แตกต่างกันในการรับประกันการเข้าถึงข้อมูล Merchant Center ที่ปลอดภัยและถูกต้อง
คำศัพท์
การลงทะเบียน การตรวจสอบสิทธิ์ และการให้สิทธิ์มีความเกี่ยวข้องกัน แต่แต่ละอย่างมีความหมายและวัตถุประสงค์ที่แตกต่างกัน
- การตรวจสอบสิทธิ์: ในกระบวนการนี้ บริการจะยืนยันตัวตนของผู้ใช้หรือแอปพลิเคชันที่ส่งคำขอ API Merchant API ใช้กลไกมาตรฐานของ Google เช่น OAuth 2.0 ระบบไม่รองรับการใช้คีย์ API สำหรับการตรวจสอบสิทธิ์ และจะทำให้เกิดข้อผิดพลาดในการตรวจสอบสิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ ตรวจสอบสิทธิ์คำขอ และ ตรวจสอบสิทธิ์ในฐานะบัญชีของคุณเอง
- การให้สิทธิ์: กระบวนการนี้จะกำหนดการดำเนินการที่ผู้ใช้หรือแอปพลิเคชันที่ผ่านการตรวจสอบสิทธิ์ ได้รับอนุญาตให้ดำเนินการโดยใช้บัญชี Merchant Center โดยจะตอบคำถามที่ว่า "คุณทำอะไรได้บ้าง" ตามบทบาทและสิทธิ์ที่มอบให้กับผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ภายในบัญชี Merchant Center ตัวอย่างเช่น ผู้ใช้อาจได้รับอนุญาตให้อ่านข้อมูลผลิตภัณฑ์ แต่ไม่ได้รับอนุญาตให้แก้ไขการตั้งค่าบัญชี
- การลงทะเบียน: สำหรับ Merchant API กระบวนการนี้เป็นการตั้งค่าแบบครั้งเดียว ที่ช่วยให้ Google ส่งประกาศสำคัญเกี่ยวกับการให้บริการสำหรับ บัญชีผู้ขายที่คุณจัดการได้ การลงทะเบียนจะเพิ่มอีเมลของนักพัฒนาแอปไปยังบัญชี Merchant Center หลักและลิงก์อีเมลดังกล่าวกับรหัสโปรเจ็กต์ Google Cloud ที่คุณใช้สำหรับการตรวจสอบสิทธิ์ การลิงก์นี้ช่วยให้แอปพลิเคชันของคุณได้รับประกาศเกี่ยวกับการให้บริการสำหรับบัญชีผู้ขายทั้งหมดที่คุณจัดการ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อสร้างโปรเจ็กต์ Google Cloud Project
การลงทะเบียน
กระบวนการลงทะเบียนมีความสำคัญอย่างยิ่งในการเปิดใช้แอปพลิเคชันของคุณให้ใช้ Merchant API ได้ สิ่งที่คุณจำเป็นต้องทราบมีดังนี้
ข้อกำหนดเบื้องต้น
การลงทะเบียนเพื่อใช้ Merchant API ต้องมีสิ่งต่อไปนี้
- บัญชี Merchant Center: คุณต้องมีบัญชี Merchant Center ที่ใช้อยู่
- สิทธิ์เข้าถึงระดับผู้ดูแลระบบ: บัญชีผู้ใช้ Google ที่คุณใช้เริ่มการเรียกการลงทะเบียนต้องมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชี Merchant Center ที่คุณลงทะเบียน
- โปรเจ็กต์ Google Cloud: แอปพลิเคชันของคุณต้องเชื่อมโยงกับโปรเจ็กต์ Google Cloud โปรเจ็กต์นี้จะให้ข้อมูลเข้าสู่ระบบที่จำเป็น (เช่น รหัสไคลเอ็นต์ OAuth 2.0) เพื่อให้แอปพลิเคชันของคุณตรวจสอบสิทธิ์ได้
เหตุผลที่คุณลงทะเบียนโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่แชร์ไม่ได้
เครื่องมือต่างๆ เช่น Google OAuth Playground และโปรแกรมสำรวจ APIs ใช้โปรเจ็กต์ Google Cloud ที่แชร์ซึ่งเป็นของ Google คุณลงทะเบียนด้วยโปรเจ็กต์ที่แชร์ไม่ได้เนื่องจากเหตุผลต่อไปนี้
- โปรเจ็กต์เหล่านี้มีไว้สำหรับการทดสอบและการสำรวจ ไม่ใช่สำหรับข้อมูลประจำตัวของแอปพลิเคชันที่ใช้งานจริง
- การลงทะเบียนโปรเจ็กต์เหล่านี้จะหมายถึงการลิงก์ระหว่างเครื่องมือที่แชร์กับข้อมูล Merchant Center เฉพาะของคุณ และอาจส่งผลให้เกิดการสื่อสารที่ไม่ต้องการ
แอปพลิเคชันของคุณต้องมีโปรเจ็กต์ Google Cloud ของตัวเองเพื่อให้การสื่อสาร Merchant API ที่ Google ส่งให้คุณยังคงเกี่ยวข้องกับการใช้งานจริงของคุณ
อย่างไรก็ตาม คุณสามารถใช้เว็บแอป OAuth Playground และโปรแกรมสำรวจ API เพื่อใช้ Merchant API สำหรับการทดลองและกรณีการใช้งานที่ไม่ใช่การใช้งานจริง
ค้นหารหัสโปรเจ็กต์ Google Cloud
คุณสามารถค้นหารหัสโปรเจ็กต์ และหมายเลขโปรเจ็กต์ ได้ใน Google Cloud Console ดูรายละเอียดได้ที่หัวข้อ ค้นหาชื่อ หมายเลข และ รหัสโปรเจ็กต์
ทำการเรียกการลงทะเบียน
ลงทะเบียนโดยใช้เมธอด
registerGcp
ภายใน API ย่อย Accounts การเรียกนี้จะเชื่อมโยงหมายเลขโปรเจ็กต์ Google Cloud กับบัญชี Merchant Center
ในระหว่างกระบวนการ คุณควรระบุอีเมลที่เชื่อมโยงกับผู้ใช้แต่ละรายที่คุณใช้เรียก API อีเมลนี้ต้องเป็นของผู้ใช้ที่มีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชี Merchant Center
เกี่ยวกับช่องอีเมล
การสื่อสารที่มีประสิทธิภาพเป็นสิ่งสำคัญ Google จะส่งข้อมูลอัปเดตที่สำคัญ ประกาศเกี่ยวกับการให้บริการที่จำเป็น (MSA) แบบสำรวจสำหรับนักพัฒนาแอป และโอกาสอื่นๆ ที่เกี่ยวข้องกับ Merchant API การจัดการข้อมูลติดต่ออย่างเหมาะสมจะช่วยให้ข้อมูลเหล่านี้เข้าถึงผู้ที่เกี่ยวข้อง
- วัตถุประ1สงค์: Google ใช้อีเมลนี้เป็นข้อมูลติดต่อหลักสำหรับการสื่อสารที่เกี่ยวข้องกับ API
- อีเมลของผู้ใด: อีเมลนี้ควรเป็นอีเมลของนักพัฒนาแอปแต่ละราย หรือข้อมูลติดต่อทางเทคนิคหลักที่รับผิดชอบการผสานรวม API
- แนวทางปฏิบัติแนะนำ:
- ควร: ใช้อีเมลของบริษัทของบุคคลนั้น
- ไม่ควร: ใช้นามแฝงกลุ่มทั่วไปหรืออีเมลบัญชีบริการ เนื่องจากเราต้องการสื่อสารกับผู้รับที่เป็นบุคคล
แหล่งข้อมูล users สำหรับการจัดการข้อมูลติดต่อ
แม้ว่าอีเมลในการเรียกการลงทะเบียนจะกำหนดข้อมูลติดต่อเริ่มต้น แต่
วิธีที่มีประสิทธิภาพมากกว่าในการจัดการข้อมูลติดต่อและการให้สิทธิ์คือการใช้ Merchant API
accounts.users
แหล่งข้อมูล หรือการตั้งค่าการจัดการผู้ใช้ใน UI ของ Merchant Center ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Merchant Center ได้ที่หัวข้อ
จัดการผู้ใช้ในบัญชี
ใช้ประโยชน์จากฟีเจอร์เหล่านี้ดังนี้
- เพิ่มนักพัฒนาแอปทั้งหมด: เพิ่มนักพัฒนาแอปที่ทำงานเกี่ยวกับการผสานรวม API เป็น ผู้ใช้บัญชี Merchant Center
- กำหนดบทบาท
API_DEVELOPER: นอกเหนือจากบทบาทมาตรฐาน (ผู้ดูแลระบบ, มาตรฐาน) คุณยังกำหนดบทบาทAPI_DEVELOPERให้กับผู้ใช้ได้ด้วย โดยเฉพาะอย่างยิ่ง ให้กำหนดบทบาทนี้ให้กับผู้ใช้ที่ควรได้รับการสื่อสารที่เกี่ยวข้องกับ API คุณสามารถกำหนดบทบาทนี้ร่วมกับบทบาทอื่นๆ ได้ - สิทธิประโยชน์:
- การแยกที่ชัดเจน: แยกการจัดการข้อมูลติดต่อ API ออกจากการลงทะเบียนแบบครั้งเดียว
- ความยืดหยุ่น: อัปเดตข้อมูลติดต่อเมื่อมีการเปลี่ยนแปลงสมาชิกในทีม
- การสื่อสารที่กำหนดเป้าหมาย: ช่วยให้มั่นใจว่าข่าวสารที่เฉพาะเจาะจงเกี่ยวกับ API จะส่งถึง ผู้ที่เกี่ยวข้อง
แม้ว่าคุณจะระบุอีเมลไว้ในระหว่างการลงทะเบียนแล้ว แต่เราขอแนะนำอย่างยิ่งให้จัดการข้อมูลติดต่อ API โดยการเพิ่มผู้ใช้ที่มีบทบาท API_DEVELOPER
ข้อมูลอ้างอิง
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อต่อไปนี้