PlainApp
API குறிப்பு

Contacts

சாதன தொடர்புகளைப் படிக்கவும், உருவாக்கவும் மற்றும் புதுப்பிக்கவும்.

வகை வரையறைகள்

bash
type Contact {
  id: ID!
  prefix: String!
  firstName: String!
  middleName: String!
  lastName: String!
  suffix: String!
  nickname: String!
  photoId: String!          # use GET /fs?id=<photoId>
  phoneNumbers: [ContactPhoneNumber!]!
  emails: [ContentItem!]!
  addresses: [ContentItem!]!
  events: [ContentItem!]!   # birthdays, anniversaries
  source: String!           # account type e.g. "com.google"
  starred: Boolean!
  contactId: ID!
  thumbnailId: String!
  notes: String!
  groups: [ContactGroup!]!
  organization: Organization
  websites: [ContentItem!]!
  ims: [ContentItem!]!
  ringtone: String!
  updatedAt: String!
}

type ContactPhoneNumber {
  value: String!
  type: Int!     # 1=home 2=mobile 3=work
  label: String!
  normalizedNumber: String!
}

type ContentItem {
  value: String!
  type: Int!
  label: String!
}

type Organization {
  company: String!
  title: String!
}

type ContactGroup {
  id: ID!
  name: String!
  contactCount: Int!
}

type ContactSource {
  name: String!
  accountType: String!
}

input ContactInput {
  firstName: String
  lastName: String
  phoneNumbers: [ContactPhoneNumberInput]
  emails: [ContentItemInput]
  organization: OrganizationInput
}

செயல்பாடுகள்

query

contacts

தொடர்புகளைத் தேடவும். அனைத்தையும் பட்டியலிட query-யை வெற்றாக விடவும்.

bash
query GetContacts($offset: Int!, $limit: Int!, $query: String!) {
  contacts(offset: $offset, limit: $limit, query: $query) {
    id firstName lastName phoneNumbers { value type }
    emails { value } source starred updatedAt
  }
}
query

contactCount

ஒரு query-யுடன் பொருந்தும் தொடர்புகளை எண்ணவும்.

bash
query GetContactCount($query: String!) {
  contactCount(query: $query)
}
query

contactSources

கிடைக்கக்கூடிய தொடர்பு கணக்கு மூலங்களை பட்டியலிடவும்.

bash
query GetContactSources {
  contactSources { name accountType }
}
query

contactGroups

அனைத்து தொடர்பு குழுக்களையும் பட்டியலிடவும்.

bash
query GetContactGroups {
  contactGroups { id name contactCount }
}
mutation

createContact

ஒரு புதிய தொடர்பை உருவாக்கவும்.

bash
mutation CreateContact($input: ContactInput!) {
  createContact(input: $input) { id firstName lastName phoneNumbers { value } }
}
mutation

updateContact

ஏற்கனவே உள்ள தொடர்பை புதுப்பிக்கவும். வழங்கப்பட்ட புலங்கள் மட்டுமே மாற்றப்படும்.

bash
mutation UpdateContact($id: ID!, $input: ContactInput!) {
  updateContact(id: $id, input: $input) { id firstName lastName updatedAt }
}
mutation

deleteContacts

ஒரு query-யுடன் பொருந்தும் அனைத்து தொடர்புகளையும் நீக்கவும்.

bash
mutation DeleteContacts($query: String!) {
  deleteContacts(query: $query)
}
mutation

createContactGroup

ஒரு குறிப்பிட்ட கணக்கில் தொடர்பு குழுவை உருவாக்கவும்.

bash
mutation CreateContactGroup($name: String!, $accountName: String!, $accountType: String!) {
  createContactGroup(name: $name, accountName: $accountName, accountType: $accountType) {
    id name contactCount
  }
}
mutation

updateContactGroup

ஒரு தொடர்பு குழுவின் பெயரை மாற்றவும்.

bash
mutation UpdateContactGroup($id: ID!, $name: String!) {
  updateContactGroup(id: $id, name: $name) { id name }
}
mutation

deleteContactGroup

ஒரு தொடர்பு குழுவை நீக்கவும். குழுவில் உள்ள தொடர்புகள் நீக்கப்படாது, குழுவிலிருந்து மட்டுமே அகற்றப்படும்.

bash
mutation DeleteContactGroup($id: ID!) {
  deleteContactGroup(id: $id)
}