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

REST Resource: accounts

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

แหล่งข้อมูล: บัญชี

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

การแสดง JSON
{
  "name": string,
  "accountName": string,
  "primaryOwner": string,
  "type": enum (AccountType),
  "role": enum (AccountRole),
  "verificationState": enum (VerificationState),
  "vettedState": enum (VettedState),
  "accountNumber": string,
  "permissionLevel": enum (PermissionLevel),
  "organizationInfo": {
    object (OrganizationInfo)
  }
}
ช่อง
name

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรในรูปแบบ accounts/{account_id}

accountName

string

ต้องระบุ ชื่อบัญชี สําหรับบัญชีประเภท PERSONAL นี่คือชื่อและนามสกุลของบัญชีผู้ใช้

primaryOwner

string

ต้องระบุ อินพุตเท่านั้น ชื่อทรัพยากรของบัญชี ซึ่งจะเป็นเจ้าของหลักของบัญชีที่กําลังสร้าง ซึ่งควรอยู่ในรูปแบบ accounts/{account_id}/

type

enum (AccountType)

ต้องระบุ มีประเภทบัญชี ไม่สามารถสร้างบัญชีประเภท PERSONAL และ ORGANIZATION โดยใช้ API นี้

role

enum (AccountRole)

เอาต์พุตเท่านั้น ระบุ AccountRole ของบัญชีนี้

verificationState

enum (VerificationState)

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

vettedState

enum (VettedState)

เอาต์พุตเท่านั้น ระบุว่า Google ตรวจสอบบัญชีแล้วหรือยัง บัญชีที่ยืนยันแล้วสามารถยืนยันสถานที่ตั้งผ่านเมธอด VETTED_PARTNER

accountNumber

string

เอาต์พุตเท่านั้น หมายเลขอ้างอิงบัญชี หากมีการจัดสรร

permissionLevel

enum (PermissionLevel)

เอาต์พุตเท่านั้น ระบุระดับสิทธิ์ที่ผู้ใช้มีสําหรับบัญชีนี้

organizationInfo

object (OrganizationInfo)

เอาต์พุตเท่านั้น ข้อมูลเพิ่มเติมสําหรับองค์กร ระบบจะป้อนข้อมูลนี้ให้กับบัญชีขององค์กรเท่านั้น

ประเภทบัญชี

ระบุประเภทของบัญชี ได้แก่ บัญชีส่วนบุคคล/บัญชีผู้ใช้ หรือบัญชีธุรกิจ

Enum
ACCOUNT_TYPE_UNSPECIFIED ไม่ได้ระบุ
PERSONAL บัญชีผู้ใช้ปลายทาง
LOCATION_GROUP กลุ่มสถานที่ตั้ง ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
USER_GROUP กลุ่มผู้ใช้สําหรับแยกทีมงานขององค์กรเป็นกลุ่ม ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
ORGANIZATION องค์กรที่เป็นตัวแทนของบริษัท ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ

บทบาทบัญชี

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

Enum
ACCOUNT_ROLE_UNSPECIFIED ไม่ได้ระบุ
PRIMARY_OWNER ผู้ใช้เป็นเจ้าของหลักของบัญชีนี้
OWNER เจ้าของบัญชี
MANAGER ผู้ใช้สามารถจัดการบัญชีนี้ได้
SITE_MANAGER ผู้ใช้สามารถจัดการชุดฟีเจอร์ที่จํากัดสําหรับบัญชีได้

สถานะการยืนยัน

ระบุสถานะการยืนยันของบัญชี

Enum
VERIFICATION_STATE_UNSPECIFIED ไม่ได้ระบุ
VERIFIED บัญชีที่ยืนยันแล้ว
UNVERIFIED บัญชีที่ไม่ได้รับการยืนยันและไม่ได้ขอการยืนยัน
VERIFICATION_REQUESTED บัญชีที่ไม่ได้รับการยืนยัน แต่มีการขอการยืนยัน

รัฐเวท

ระบุสถานะที่ได้รับการตรวจสอบของบัญชี

Enum
VETTED_STATE_UNSPECIFIED ไม่ได้ระบุ
NOT_VETTED บัญชีไม่ได้ได้รับการตรวจสอบจาก Google
VETTED บัญชีได้รับการตรวจสอบจาก Google และอยู่ในสถานะที่ถูกต้องแล้ว บัญชีจะได้รับการตรวจสอบโดยอัตโนมัติหากมีการเข้าถึงบัญชีกลุ่มที่ผ่านการตรวจสอบโดยตรง
INVALID บัญชีนี้ได้รับการตรวจสอบแล้วแต่อยู่ในสถานะที่ไม่ถูกต้อง บัญชีดังกล่าวจะมีลักษณะการทํางานเหมือนบัญชีที่ไม่มีการตรวจสอบ

ระดับสิทธิ์

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

Enum
PERMISSION_LEVEL_UNSPECIFIED ไม่ได้ระบุ
OWNER_LEVEL ผู้ใช้มีสิทธิ์ระดับเจ้าของ
MEMBER_LEVEL ผู้ใช้มีสิทธิ์ระดับสมาชิก

ข้อมูลองค์กร

ข้อมูลเพิ่มเติมที่จัดเก็บไว้สําหรับองค์กร

การแสดง JSON
{
  "registeredDomain": string,
  "address": {
    object (PostalAddress)
  },
  "phoneNumber": string
}
ช่อง
registeredDomain

string

เอาต์พุตเท่านั้น โดเมนที่ลงทะเบียนของบัญชี

address

object (PostalAddress)

เอาต์พุตเท่านั้น ที่อยู่ไปรษณีย์ของบัญชี

phoneNumber

string

เอาต์พุตเท่านั้น หมายเลขติดต่อขององค์กร

PostalAddress

แสดงที่อยู่ทางไปรษณีย์ เช่น ที่อยู่สําหรับจัดส่งทางไปรษณีย์หรือการชําระเงิน ที่อยู่ทางไปรษณีย์จะช่วยให้บริการไปรษณีย์นําสินค้าไปส่งที่ตู้ไปรษณีย์ ตู้ไปรษณีย์ หรือตู้อื่นๆ ที่คล้ายกันได้ ไม่ได้มีจุดมุ่งหมายให้สร้างแบบจําลองสถานที่ตั้งทางภูมิศาสตร์ (ถนน เมือง ภูเขา)

ในการใช้งานทั่วไป ระบบจะสร้างที่อยู่ที่ผู้ใช้ป้อนหรือนําเข้าข้อมูลที่มีอยู่ ทั้งนี้ขึ้นอยู่กับประเภทของกระบวนการ

คําแนะนําเกี่ยวกับการป้อนข้อมูล/การแก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่ที่เป็นภาษาสากล เช่น https://github.com/google/libaddressinput) - ผู้ใช้ไม่ควรเห็นองค์ประกอบ UI สําหรับการป้อนข้อมูลหรือการแก้ไขช่องนอกเขตข้อมูลที่ใช้ช่องดังกล่าว

ดูคําแนะนําเพิ่มเติมเกี่ยวกับวิธีใช้สคีมานี้ได้ที่ https://support.google.com/business/answer/6397478

การแสดง JSON
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
ช่อง
revision

integer

การแก้ไขสคีมาของ PostalAddress ต้องตั้งค่านี้เป็น 0 ซึ่งเป็นการแก้ไขครั้งล่าสุด

การแก้ไขใหม่ทั้งหมดต้องเข้ากันได้กับเวอร์ชันก่อนหน้า

regionCode

string

ต้องระบุ รหัสภูมิภาคของ CLDR ของประเทศ/ภูมิภาคของที่อยู่ ค่านี้ไม่ได้อนุมานและขึ้นอยู่กับผู้ใช้เพื่อให้แน่ใจว่าค่าถูกต้อง ดูรายละเอียดได้ที่ https://cldr.unicode.org/ และ https://www.unicode.org/cldr/Chars/30/supplemental/territory_information.html ตัวอย่าง: "CH" สําหรับสวิตเซอร์แลนด์

languageCode

string

ไม่บังคับ รหัสภาษาของ BCP-47 ของที่อยู่นี้ (หากทราบ) ซึ่งมักเป็นภาษา UI ของแบบฟอร์มอินพุตหรือต้องไม่ตรงกับภาษาใดภาษาหนึ่งที่ใช้ในที่อยู่' ประเทศ/ภูมิภาค หรือคําใกล้เคียงที่ทับศัพท์ การดําเนินการนี้อาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่สําคัญต่อความถูกต้องของข้อมูล และจะไม่ส่งผลต่อการตรวจสอบความถูกต้องหรือการดําเนินการอื่นๆ ที่เกี่ยวข้องกับการจัดรูปแบบ

หากไม่ทราบค่านี้ คุณควรละเว้นค่านี้ (แทนการระบุเริ่มต้นที่ไม่ถูกต้อง)

ตัวอย่างเช่น: "zh-Hant", "ja", "ja-Latn", "en"

postalCode

string

ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศอาจไม่ได้ใช้หรือกําหนดให้ต้องมีรหัสไปรษณีย์แสดง แต่จะนําไปใช้ที่ไหน ประเทศเหล่านี้อาจเรียกใช้การตรวจสอบเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบความถูกต้องของรัฐ/รหัสไปรษณีย์ในสหรัฐอเมริกา)

sortingCode

string

ไม่บังคับ รหัสการจัดเรียง รหัสเฉพาะในแต่ละประเทศ ซึ่งไม่ได้ใช้ในภูมิภาคส่วนใหญ่ เมื่อใช้งาน ค่าจะเป็นสตริง เช่น "CEDEX" (ไม่บังคับ) ตามด้วยตัวเลข (เช่น "CEDEX 7") หรือเป็นตัวเลขเพียงอย่างเดียว โดยแสดงถึง "sector โค้ด" (จาเมกา) "ดัชนีพื้นที่นําส่ง" (Malawi) หรือ &reti;หมายเลขกํากับสํานักงาน&&;"ข้อความ หมายเลขกํากับ;

administrativeArea

string

ไม่บังคับ เขตการปกครองที่สูงที่สุด ซึ่งใช้สําหรับที่อยู่ทางไปรษณีย์ของประเทศหรือภูมิภาค ซึ่งอาจเป็นรัฐ จังหวัด แคว้น หรือจังหวัด สําหรับสเปน นี่คือจังหวัดและไม่ใช่ชุมชนปกครองตนเอง (เช่น "Barcelona" และไม่ใช่ "Catalonia") หลายประเทศไม่ได้ใช้เขตบริหารในที่อยู่ทางไปรษณีย์ เช่น ในสวิตเซอร์แลนด์ไม่ควรเลือกตัวเลือกนี้

locality

string

ไม่บังคับ โดยทั่วไปหมายถึงชื่อเมืองส่วนของเมืองของที่อยู่ ตัวอย่าง: เมืองของสหรัฐฯ, เทศบาลด้านไอที, เมืองตามเขตไปรษณีย์ของสหราชอาณาจักร ในภูมิภาคต่างๆ ในโลกที่พื้นที่ไม่เข้ากับพื้นที่หรือไม่ค่อยอยู่ในโครงสร้างนี้ ให้เว้นย่านไว้และใช้ที่อยู่

sublocality

string

ไม่บังคับ ที่อยู่ย่อยของที่อยู่ ตัวอย่างเช่น อาจเป็นละแวก เขตเมือง หรือเขต

addressLines[]

string

บรรทัดที่ไม่มีโครงสร้างซึ่งอธิบายระดับต่างๆ ของที่อยู่

เนื่องจากค่าใน addresslines ไม่มีข้อมูลประเภท และบางครั้งอาจมีค่าหลายค่าในช่องเดียว (เช่น "Austin, TX") จึงเป็นสิ่งสําคัญที่ลําดับจะต้องชัดเจน ลําดับของบรรทัดที่อยู่ควรเป็น "ลําดับซองจดหมาย" สําหรับประเทศ/ภูมิภาคของที่อยู่นั้น ในที่ที่สามารถเปลี่ยนแปลงได้ (เช่น ญี่ปุ่น) address_language จะใช้เพื่อทําให้มีความโจ่งแจ้ง (เช่น "ja" สําหรับการจัดเรียงจากมากไปน้อยและ "ja-Latn" หรือ "en" สําหรับธุรกิจขนาดเล็กถึงใหญ่) วิธีนี้จะทําให้ระบบเลือกบรรทัดที่เจาะจงมากที่สุดของที่อยู่ตามภาษาได้

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

การสร้างที่อยู่ที่มีภูมิภาค codeCode และ addressLine เท่านั้น แล้วแนะนําให้ใช้การเข้ารหัสพิกัดเพื่อจัดการกับที่อยู่ที่ไม่มีโครงสร้างโดยสมบูรณ์ (ซึ่งต่างจากการคาดเดาว่าที่อยู่ส่วนไหนควรเป็นย่านท้องถิ่นหรือพื้นที่บริหาร)

recipients[]

string

ไม่บังคับ ผู้รับตามที่อยู่ ช่องนี้อาจมีข้อมูลหลายบรรทัดในบางกรณี เช่น อาจมี&"การดูแลรักษา" ข้อมูล

organization

string

ไม่บังคับ ชื่อองค์กรของที่อยู่

วิธีการ

create

สร้างบัญชีที่มีชื่อและประเภทตามที่ระบุในส่วนระดับบนสุดที่ระบุ

get

รับบัญชีที่ระบุ

list

แสดงรายการบัญชีทั้งหมดสําหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

patch

อัปเดตบัญชีธุรกิจที่ระบุ