คุณควรเข้าใจแนวคิดเรื่องการลงทะเบียน การตรวจสอบสิทธิ์ และการให้สิทธิ์ เพื่อให้ใช้ Merchant API ได้อย่างมีประสิทธิภาพ ซึ่งมีวัตถุประสงค์ที่แตกต่างกันในการรับประกันการเข้าถึงข้อมูล Merchant Center ที่ปลอดภัยและถูกต้อง
คำศัพท์
การลงทะเบียน การตรวจสอบสิทธิ์ และการให้สิทธิ์มีความเกี่ยวข้องกัน แต่แต่ละอย่างก็มีความหมายและวัตถุประสงค์ที่แตกต่างกัน
- การตรวจสอบสิทธิ์: ในกระบวนการนี้ บริการจะยืนยันตัวตนของผู้ใช้หรือแอปพลิเคชันที่ส่งคำขอ API Merchant API ใช้กลไกมาตรฐานของ Google เช่น OAuth 2.0 ดูข้อมูลเพิ่มเติมได้ที่หัวข้อตรวจสอบสิทธิ์ คำขอและ ตรวจสอบสิทธิ์ในฐานะ บัญชีของคุณเอง
- การให้สิทธิ์: กระบวนการนี้จะกำหนดการดำเนินการที่ผู้ใช้หรือแอปพลิเคชันที่ผ่านการตรวจสอบสิทธิ์ ได้รับอนุญาตให้ดำเนินการโดยใช้บัญชี 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 การจัดการรายชื่อติดต่ออย่างเหมาะสมจะช่วยให้ข้อมูลเหล่านี้เข้าถึงผู้ที่เกี่ยวข้อง
- วัตถุประสงค์: 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
ข้อมูลอ้างอิง
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อต่อไปนี้