API குறிப்பு

Tags

டேக்கள் ஒரு DataType-க்கு ஒரு வரையறைப்படுத்தப்பட்டவை (images, audio, video, files, contacts, SMS, calls, notes). டேக்கள் மற்றும் உருப்படி ஒதுக்கீடுகளை இங்கே நிர்வகிக்கவும்.

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

bash
type Tag {
  id: ID!
  name: String!
  count: Int!   # total items carrying this tag
}

type TagRelation {
  tagId: ID!
  key: String!  # id of the tagged item
}

# DataType scopes which content type a tag belongs to
enum DataType {
  AUDIO VIDEO IMAGE SMS CONTACT NOTE FEED_ENTRY CALL DOC PACKAGE FILE
}

# Identifies a single item by its ID key, used in updateTagRelations
input TagRelationStub {
  key: String!
}

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

query

tags

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

bash
query GetTags($type: DataType!) {
  tags(type: $type) { id name count }
}
query

tagRelations

ஒரு தரவு வகைக்குள் உருப்படி keys தொகுப்பிற்கான (உதா. media IDs, note IDs) டேக் ஒதுக்கீடுகளைத் தேடவும்.

bash
query GetTagRelations($type: DataType!, $keys: [String!]!) {
  tagRelations(type: $type, keys: $keys) {
    tagId
    key
  }
}
mutation

createTag

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

bash
mutation CreateTag($type: DataType!, $name: String!) {
  createTag(type: $type, name: $name) { id name count }
}
mutation

updateTag

ஏற்கனவே உள்ள டேக்கின் பெயரை மாற்றவும்.

bash
mutation UpdateTag($id: ID!, $name: String!) {
  updateTag(id: $id, name: $name) { id name }
}
mutation

deleteTag

ஒரு டேக்கை நீக்கி அதை அனைத்து டேக் செய்யப்பட்ட உருப்படிகளிலிருந்தும் அகற்றவும்.

bash
mutation DeleteTag($id: ID!) {
  deleteTag(id: $id)
}
mutation

addToTags

ஒரு query-யுடன் பொருந்தும் அனைத்து உருப்படிகளையும் ஒன்று அல்லது அதற்கு மேற்பட்ட டேக்களுக்குச் சேர்க்கவும்.

bash
mutation AddToTags($type: DataType!, $tagIds: [ID!]!, $query: String!) {
  addToTags(type: $type, tagIds: $tagIds, query: $query)
}
mutation

updateTagRelations

ஒரே அழைப்பில் ஒரு ஒற்றை உருப்படியில் டேக்களைச் சேர்க்கவும் மற்றும்/அல்லது அகற்றவும்.

bash
mutation UpdateTagRelations($type: DataType!, $item: TagRelationStub!, $addTagIds: [ID!]!, $removeTagIds: [ID!]!) {
  updateTagRelations(type: $type, item: $item, addTagIds: $addTagIds, removeTagIds: $removeTagIds)
}
mutation

removeFromTags

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

bash
mutation RemoveFromTags($type: DataType!, $tagIds: [ID!]!, $query: String!) {
  removeFromTags(type: $type, tagIds: $tagIds, query: $query)
}