จัดการสถานที่ตั้งในวงกว้าง

เมื่อองค์กรเติบโตขึ้น การจัดการสถานที่ตั้งและสิทธิ์อาจทำให้คุณปวดหัวได้ คู่มือนี้จะอธิบายแนวทางปฏิบัติแนะนำในการจัดการสถานที่ตั้งหลายแห่ง และอธิบายประเภทบัญชีต่อไปนี้

• บัญชีส่วนตัว
• บัญชีขององค์กร
• บัญชีกลุ่มสถานที่ตั้ง
• บัญชีกลุ่มผู้ใช้

ประเภทบัญชี

บัญชีแต่ละประเภทมีบทบาทในการจัดการสถานที่ตั้ง บัญชีส่วนบุคคลจะจัดการบัญชีขององค์กรได้ จากนั้นจะได้รับสิทธิ์เข้าถึงกลุ่มผู้ใช้และกลุ่มสถานที่ในองค์กรนั้น จากนั้นบัญชีส่วนบุคคลจะจัดการสถานที่ตั้งและข้อมูลผ่านกลุ่มสถานที่ตั้งที่เกี่ยวข้องได้

บัญชีส่วนตัว

บัญชีส่วนบุคคลจะพร้อมใช้งานโดยอัตโนมัติเมื่อคุณสร้างบัญชี Google บัญชีส่วนบุคคลสามารถเป็นเจ้าของและผู้จัดการข้อมูล

บัญชีขององค์กร

บัญชีองค์กรคือบัญชีที่ครอบคลุมซึ่งแสดงถึงเอเจนซีของคุณ ระบบจะบันทึกกลุ่มสถานที่ตั้งและกลุ่มผู้ใช้ไว้ในที่เก็บข้อมูลดังกล่าว และสมาชิกทุกคนในองค์กรจะมีสิทธิ์เข้าถึง สถานที่ตั้งอาจเป็นส่วนหนึ่งขององค์กรได้หลายแห่ง

เมื่อใช้ My Business Account Management API คุณจะใช้วิธี accounts.admins.create เพื่อเชิญบัญชีส่วนบุคคลให้จัดการหรือเป็นเจ้าของบัญชีขององค์กรได้

บัญชีกลุ่มสถานที่ตั้ง

กลุ่มสถานที่ตั้งใช้เพื่อจัดการกลุ่มสถานที่ตั้งแต่ละแห่ง คุณสามารถใช้กลุ่มสถานที่ตั้งเพื่อดําเนินการแบบเป็นกลุ่มกับสถานที่ตั้งหลายแห่ง เมื่อคุณเพิ่มบัญชีส่วนบุคคลและกลุ่มผู้ใช้ลงในกลุ่มสถานที่ตั้ง บัญชีและกลุ่มผู้ใช้เหล่านั้นจะได้รับสิทธิ์ของกลุ่มสถานที่ตั้ง

นอกจากนี้ คุณยังสร้างกลุ่มสถานที่ตั้งเพื่อจัดหมวดหมู่สถานที่ตั้ง เช่น ตามเครือ ภูมิภาค หรือหมวดหมู่ได้ด้วย สถานที่ตั้งจะอยู่ในกลุ่มสถานที่ตั้งได้หลายกลุ่มพร้อมกัน

หมายเหตุ: บัญชีส่วนตัวที่เป็นขององค์กรหรือกลุ่มผู้ใช้จะไม่มีสิทธิ์เป็นเจ้าของสถานที่หรือกลุ่มสถานที่ตั้งโดยตรง

เมื่อใช้ My Business Account Management API คุณจะใช้เมธอด accounts.create เพื่อสร้างกลุ่มสถานที่ตั้ง และโอนสถานที่ตั้งไปยังกลุ่มสถานที่ตั้งได้ นอกจากนี้ คุณยังเชิญบัญชีส่วนบุคคลให้จัดการกลุ่มสถานที่ตั้งด้วย API ได้ด้วย คุณสามารถเพิ่มกลุ่มผู้ใช้ไปยังกลุ่มสถานที่ได้โดยตรงจากอินเทอร์เฟซเว็บ

บัญชีกลุ่มผู้ใช้

หากต้องการจัดการสิทธิ์ในวงกว้าง ให้ใช้กลุ่มผู้ใช้ คุณสามารถเพิ่มบัญชีส่วนตัวลงในกลุ่มผู้ใช้ได้ จากนั้นคุณสามารถให้สิทธิ์ผู้ใช้เข้าถึงการจัดการกลุ่มไปยังกลุ่มสถานที่ตั้งหลายกลุ่มในองค์กร ตอนนี้บัญชีส่วนบุคคลทั้งหมดในกลุ่มผู้ใช้จะดําเนินการด้านการจัดการในสถานที่ตั้งภายใต้กลุ่มสถานที่ตั้งได้

หมายเหตุ: คุณไม่ควรเพิ่มบัญชีส่วนตัวลงในกลุ่มสถานที่ตั้ง ให้สิทธิ์เข้าถึงกลุ่มผู้ใช้โดยตรงแทน วิธีนี้ช่วยให้จัดการได้ง่ายขึ้นเมื่อใช้กับหลายรายการ

ตัวอย่างเช่น เมื่อสมาชิกใหม่เข้าร่วมทีมปฏิบัติการ คุณสามารถเพิ่มบุคคลดังกล่าวลงในกลุ่มผู้ใช้ได้โดยตรง และบุคคลดังกล่าวจะมีสิทธิ์เข้าถึงสถานที่ทั้งหมดที่เพื่อนร่วมงานมีสิทธิ์เข้าถึงได้ทันที การให้สิทธิ์ผู้ใช้เข้าถึงสถานที่แต่ละแห่งจะใช้เวลานานกว่าและจัดการได้ยากกว่า

เมื่อใช้ My Business Account Management API คุณจะใช้เมธอด accounts.create เพื่อสร้างกลุ่มผู้ใช้ได้ นอกจากนี้ คุณยังใช้ API เพื่อเชิญบัญชีส่วนตัวให้จัดการผู้ดูแลระบบสําหรับบัญชีและสถานที่ตั้งได้ด้วย

ใช้ API เพื่อเรียกรายการบัญชีทั้งหมด

หากต้องการแสดงรายการบัญชีทั้งหมดที่คุณมีสิทธิ์เข้าถึงและประเภทบัญชีที่เชื่อมโยง ให้เรียกใช้เมธอด accounts.list ด้วยข้อมูลเข้าสู่ระบบ OAuth การตอบกลับจะมีรายการบัญชีทั้งหมด รหัสบัญชีของบัญชีเหล่านั้น ซึ่งแสดงอยู่ในช่องชื่อ และประเภทบัญชี

ส่งคำขอ

ตัวอย่างคำขอ accounts.list มีดังนี้

HTTP

GET
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Authorization: Bearer <access_token>

คำตอบ

ต่อไปนี้เป็นตัวอย่างการตอบกลับ accounts.list

{
    "accounts": [
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe",
            "type": "PERSONAL",
            "state": {
                "status": "UNVERIFIED"
            },
            "profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
        },
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe’s Location Group",
            "type": "LOCATION_GROUP",
            "role": "OWNER",
            "state": {
                "status": "UNVERIFIED"
            },
            "accountNumber": "{accountNumber}",
            "permissionLevel": "OWNER_LEVEL"
        }
    ]
}

ประเภทบัญชีทั้งหมดที่ระบุไว้ในคู่มือนี้อาจรวมอยู่ในคําตอบสําหรับคําขอaccounts.list ตรวจสอบรายการบัญชีและระบุบัญชีที่เจาะจงซึ่งมีสิทธิ์เข้าถึงสถานที่ตั้งที่คุณต้องการจัดการ จากนั้นเรียกใช้ accounts.locations.list ด้วยช่องชื่อของบัญชีที่เฉพาะเจาะจงเพื่อดึงข้อมูลรายการสถานที่ตั้งที่บัญชีนั้นเข้าถึงได้

เช่น หากต้องการดึงข้อมูลสถานที่ตั้งทั้งหมดของ "กลุ่มสถานที่ตั้งของ John Doe" ให้ส่งคำขอต่อไปนี้

HTTP

GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>

การตอบกลับจะแสดงรายการสถานที่ที่ผู้ใช้มีสิทธิ์เข้าถึง ดังนี้

{
    "locations": [
        {
            "name": "locations/{locationId}",
            "locationName": "Test Business",
            ...
        },
        {
            "name": "locations/{locationId}",
            "locationName": "2nd Test Business",
            ...
         }
     ]
}

แผนภาพการจัดการสถานที่

แผนภาพต่อไปนี้แสดงข้อมูลต่อไปนี้

• องค์กรอาจมีกลุ่มผู้ใช้หลายกลุ่ม
• กลุ่มผู้ใช้จะจัดการกลุ่มสถานที่ตั้งได้หลายกลุ่ม
• กลุ่มสถานที่ตั้งอาจมีสถานที่ตั้งหลายแห่ง
• สถานที่ตั้งอาจครอบคลุมกลุ่มสถานที่ตั้งหลายกลุ่มในองค์กร

รูปที่ 1 ลําดับชั้นการจัดการสถานที่