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

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

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

ประเภทบัญชี

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

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

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

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

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

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

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

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

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

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

เมื่อใช้ 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 ด้วยช่องชื่อของบัญชีที่ต้องการเพื่อเรียกข้อมูลรายการสถานที่ที่บัญชีนั้นมีสิทธิ์เข้าถึง

ตัวอย่างเช่น หากคุณต้องการดึงข้อมูลสถานที่ทั้งหมดที่อยู่ใน "กลุ่มสถานที่ตั้งของ จอห์น โด" ให้ส่งคำขอต่อไปนี้

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 ลำดับชั้นการจัดการสถานที่ตั้ง