Method: people.batchCreateContacts

สร้างกลุ่มรายชื่อติดต่อใหม่ และส่งกลับ PersonResponses สำหรับรายการใหม่

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

คำขอ HTTP

POST https://people.googleapis.com/v1/people:batchCreateContacts

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
ช่อง
contacts[]

object (ContactToCreate)

ต้องระบุ รายชื่อติดต่อที่จะสร้าง อนุญาตรายชื่อติดต่อสูงสุด 200 รายการในคำขอเดียว
readMask

string (FieldMask format)

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

  • ที่อยู่
  • ageRanges
  • ชีวประวัติ
  • วันเกิด
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • กิจกรรม
  • externalIds
  • เพศ
  • imClients
  • ความสนใจ
  • locales
  • สถานที่ตั้ง
  • ของช่อง
  • ข้อมูลเมตา
  • miscKeywords
  • names
  • ชื่อเล่น
  • อาชีพ
  • organizations
  • phoneNumbers
  • ภาพถ่าย
  • ความสัมพันธ์
  • sipAddresses
  • ทักษะ
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

ไม่บังคับ มาสก์ของประเภทแหล่งที่มาที่จะแสดงผลในการอ่านหลังเปลี่ยนแปลง ค่าเริ่มต้นจะเป็น READ_SOURCE_TYPE_CONTACT และ READ_SOURCE_TYPE_PROFILE หากไม่ได้ตั้งค่าไว้

เนื้อหาการตอบกลับ

หากไม่สำเร็จ ระบบจะแสดง BatchCreateContactsErrorDetails ซึ่งมีรายการข้อผิดพลาดสำหรับรายชื่อติดต่อที่ไม่ถูกต้องแต่ละรายการ

การตอบกลับคำขอสร้างกลุ่มรายชื่อติดต่อ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
ช่อง
createdPeople[]

object (PersonResponse)

รายชื่อติดต่อที่สร้างขึ้น ยกเว้นคำขอ readMask ว่างเปล่า

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/contacts

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์

ContactToCreate

Wrapper ที่มีข้อมูลบุคคลสำหรับป้อนข้อมูลแหล่งที่มาที่สร้างขึ้นใหม่

การแสดง JSON 
{
  "contactPerson": {
    object (Person)
  }
}
ช่อง
contactPerson

object (Person)

ต้องระบุ ข้อมูลบุคคลที่จะเติมลงในแหล่งที่มาที่สร้างขึ้นใหม่