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

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

ประเภทบัญชี

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

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

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

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

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

ด้วย 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 จะมีรายการบัญชีทั้งหมด รหัสบัญชี ที่อยู่ในช่อง name และประเภทบัญชี

ส่งคำขอ

ต่อไปนี้เป็น ตัวอย่างคำขอ 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's กลุ่มสถานที่ตั้ง" ส่งคำขอต่อไปนี้

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