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