หากต้องการใช้ Merchant API อย่างมีประสิทธิภาพ คุณควรทำความเข้าใจแนวคิดเรื่องการลงทะเบียน การตรวจสอบสิทธิ์ และการให้สิทธิ์ โดยมีวัตถุประสงค์ที่แตกต่างกันในการรับประกันการเข้าถึงข้อมูล Merchant Center ที่ปลอดภัยและถูกต้อง
คำศัพท์
การลงทะเบียน การตรวจสอบสิทธิ์ และการให้สิทธิ์มีความเกี่ยวข้อง แต่แต่ละอย่างก็มี ความหมายและวัตถุประสงค์ที่แตกต่างกัน
- การตรวจสอบสิทธิ์: ในกระบวนการนี้ บริการจะยืนยันตัวตนของผู้ใช้หรือแอปพลิเคชันที่ส่งคำขอ API Merchant API ใช้กลไกมาตรฐานของ Google เช่น OAuth 2.0 ดูข้อมูลเพิ่มเติมได้ที่หัวข้อตรวจสอบสิทธิ์ คำขอและ ตรวจสอบสิทธิ์ในฐานะบัญชีของคุณเอง
- การให้สิทธิ์: กระบวนการนี้จะกำหนดการดำเนินการที่ผู้ใช้หรือแอปพลิเคชันที่ได้รับการตรวจสอบสิทธิ์ ได้รับอนุญาตให้ดำเนินการโดยใช้บัญชี Merchant Center โดยจะตอบคำถามที่ว่า "คุณทำอะไรได้บ้าง" ตามบทบาทและ สิทธิ์ที่มอบให้แก่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ภายในบัญชี Merchant Center เช่น ผู้ใช้อาจได้รับอนุญาตให้อ่านข้อมูลผลิตภัณฑ์ แต่ไม่ได้รับอนุญาตให้แก้ไขการตั้งค่าบัญชี
- การลงทะเบียน: สำหรับ Merchant API กระบวนการนี้เป็นการตั้งค่าแบบครั้งเดียวที่ช่วยให้ Google ส่งประกาศการให้บริการที่สำคัญสำหรับบัญชีผู้ขายที่คุณจัดการได้ การลงทะเบียนจะเพิ่มอีเมลของนักพัฒนาแอป ลงในบัญชี Merchant Center หลักและลิงก์กับรหัสโปรเจ็กต์ Google Cloud ที่คุณใช้สำหรับการตรวจสอบสิทธิ์ การลิงก์นี้ช่วยให้แอปพลิเคชันของคุณได้รับการประกาศเกี่ยวกับบริการสำหรับบัญชีผู้ขายทั้งหมดที่คุณจัดการ ดูข้อมูลเพิ่มเติมได้ที่สร้างโปรเจ็กต์ Google Cloud
การลงทะเบียน
กระบวนการลงทะเบียนมีความสำคัญอย่างยิ่งต่อการเปิดใช้แอปพลิเคชันของคุณเพื่อใช้ Merchant API สิ่งที่จำเป็นต้องทราบมีดังนี้
ข้อกำหนดเบื้องต้น
การลงทะเบียนเพื่อใช้ Merchant API ต้องมีสิ่งต่อไปนี้
- บัญชี Merchant Center: คุณต้องมีบัญชี Merchant Center ที่ใช้อยู่
- สิทธิ์เข้าถึงระดับผู้ดูแลระบบ: บัญชีผู้ใช้ Google ที่คุณใช้เพื่อเริ่มการเรียกการลงทะเบียนต้องมีสิทธิ์ระดับผู้ดูแลระบบในบัญชี Merchant Center ที่คุณลงทะเบียน
- โปรเจ็กต์ Google Cloud: แอปพลิเคชันของคุณต้องเชื่อมโยงกับโปรเจ็กต์ Google Cloud โปรเจ็กต์นี้มีข้อมูลเข้าสู่ระบบที่จำเป็น (เช่น รหัสไคลเอ็นต์ OAuth 2.0) เพื่อให้แอปพลิเคชันของคุณตรวจสอบสิทธิ์ได้
เหตุผลที่คุณลงทะเบียนโปรเจ็กต์ Google Cloud ที่แชร์ไม่ได้
เครื่องมือต่างๆ เช่น Google OAuth Playground และโปรแกรมสำรวจ APIs จะใช้โปรเจ็กต์ Google Cloud ที่แชร์ซึ่ง Google เป็นเจ้าของ คุณจะลงทะเบียนด้วยโปรเจ็กต์ที่แชร์ไม่ได้ เนื่องจากสาเหตุต่อไปนี้
- โดยมีไว้สำหรับการทดสอบและการสำรวจ ไม่ใช่สำหรับการใช้งานจริง
- การลงทะเบียนจะหมายถึงลิงก์ระหว่างเครื่องมือที่แชร์กับข้อมูล Merchant Center ที่เฉพาะเจาะจงของคุณ และอาจส่งผลให้มีการสื่อสารที่ไม่ต้องการ
แอปพลิเคชันของคุณต้องมีโปรเจ็กต์ Google Cloud ของตัวเองโดยเฉพาะ เพื่อให้การสื่อสารผ่าน Merchant API ที่ Google ส่งถึงคุณยังคงเกี่ยวข้องกับการใช้งานจริงของคุณ
อย่างไรก็ตาม คุณสามารถใช้เว็บแอป OAuth Playground และ API Explorer เพื่อใช้ Merchant API สำหรับ Use Case ในการทดลองและที่ไม่ใช่การใช้งานจริง
ค้นหารหัสโปรเจ็กต์ Google Cloud
คุณจะดูรหัสโปรเจ็กต์และหมายเลขโปรเจ็กต์ได้ใน Google Cloud Console โปรดดูรายละเอียดที่หัวข้อค้นหาชื่อ หมายเลข และรหัสโปรเจ็กต์
โทรเพื่อลงทะเบียน
ลงทะเบียนโดยใช้เมธอด
registerGcp
ภายใน Accounts Sub-API การเรียกนี้จะเชื่อมโยงหมายเลขโปรเจ็กต์ Google Cloud
กับบัญชี Merchant Center
ในระหว่างกระบวนการ คุณควรระบุอีเมลที่เชื่อมโยงกับ ผู้ใช้แต่ละรายที่คุณใช้เรียก API อีเมลนี้ต้องเป็นของผู้ใช้ที่มีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชี Merchant Center
เกี่ยวกับช่องอีเมล
การสื่อสารที่มีประสิทธิภาพคือกุญแจสำคัญ Google จะส่งข้อมูลอัปเดตที่สำคัญ ประกาศเกี่ยวกับการให้บริการที่จำเป็น (MSA) แบบสำรวจสำหรับนักพัฒนาแอป และโอกาสอื่นๆ ที่เกี่ยวข้องกับ Merchant API การจัดการรายชื่อติดต่ออย่างเหมาะสมจะช่วยให้ข้อความเหล่านี้เข้าถึง ผู้ที่เกี่ยวข้อง
- วัตถุประสงค์: 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
ข้อมูลอ้างอิง
ดูข้อมูลเพิ่มเติมได้ที่