คุณควรเข้าใจแนวคิดเรื่องการลงทะเบียน การตรวจสอบสิทธิ์ และการให้สิทธิ์ เพื่อให้ใช้ 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
เมธอดภายใน Accounts sub-API การเรียกนี้จะเชื่อมโยงหมายเลขโปรเจ็กต์ 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
ข้อมูลอ้างอิง
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อต่อไปนี้