Segnalibri
Verificare app.capabilities per il supporto delle funzionalità e app.access insieme alle autorizzazioni host per l’autorizzazione. Gli esempi usano valori sintetici; sostituire percorsi, ID, input e filtri prima della chiamata.
Definizioni di tipo
type Mutation {
addBookmarks(urls: [String!]!, groupId: ID!): [Bookmark!]!
createBookmarkGroup(name: String!): BookmarkGroup!
deleteBookmarkGroup(id: ID!): Boolean!
deleteBookmarks(ids: [ID!]!): ActionResult!
importBookmarks(content: String!): ActionResult!
recordBookmarkClick(id: ID!): Boolean!
updateBookmark(id: ID!, input: BookmarkInput!): Bookmark!
updateBookmarkGroup(id: ID!, name: String!, collapsed: Boolean!, sortOrder: Int!): BookmarkGroup!
}
type Query {
bookmark(id: ID!): Bookmark
bookmarkGroups: [BookmarkGroup!]!
bookmarks: [Bookmark!]!
pageMetadata(url: String!): PageMetadata!
}
type Subscription {
bookmarksUpdated: [Bookmark!]!
}
type ActionResult {
affectedCount: Int!
}
type Bookmark {
id: ID!
url: String!
title: String!
faviconPath: String!
groupId: ID!
pinned: Boolean!
clickCount: Int!
sortOrder: Int!
createdAt: Instant!
updatedAt: Instant!
lastClickedAt: Instant
}
type BookmarkGroup {
id: ID!
name: String!
collapsed: Boolean!
sortOrder: Int!
itemCount: Int!
createdAt: Instant!
updatedAt: Instant!
}
input BookmarkInput {
url: String!
title: String!
faviconUrl: String
groupId: ID!
pinned: Boolean!
sortOrder: Int!
}
scalar Instant
type PageMetadata {
title: String
faviconUrl: String
}Operazioni
addBookmarks
Creare segnalibri per gli URL forniti nel gruppo specificato.
mutation addBookmarks($urls: [String!]!, $groupId: ID!) {
addBookmarks(urls: $urls, groupId: $groupId) { id url title faviconPath groupId pinned clickCount sortOrder }
}createBookmarkGroup
Creare un gruppo di segnalibri.
mutation createBookmarkGroup($name: String!) {
createBookmarkGroup(name: $name) { id name collapsed sortOrder itemCount createdAt updatedAt }
}deleteBookmarkGroup
Eliminare un gruppo di segnalibri. I segnalibri contenuti non vengono eliminati, ma solo rimossi dal gruppo.
mutation deleteBookmarkGroup($id: ID!) {
deleteBookmarkGroup(id: $id)
}deleteBookmarks
Eliminare uno o più segnalibri tramite ID.
mutation deleteBookmarks($ids: [ID!]!) {
deleteBookmarks(ids: $ids) { affectedCount }
}importBookmarks
Importare segnalibri dal contenuto del documento fornito e indicare il numero interessato.
mutation importBookmarks($content: String!) {
importBookmarks(content: $content) { affectedCount }
}recordBookmarkClick
Incrementare il conteggio delle visite memorizzato di un segnalibro.
mutation recordBookmarkClick($id: ID!) {
recordBookmarkClick(id: $id)
}updateBookmark
Aggiornare uno o più campi di un segnalibro esistente.
mutation updateBookmark($id: ID!, $input: BookmarkInput!) {
updateBookmark(id: $id, input: $input) { id url title faviconPath groupId pinned clickCount sortOrder }
}updateBookmarkGroup
Aggiornare nome, stato compresso o ordinamento di un gruppo di segnalibri.
mutation updateBookmarkGroup($id: ID!, $name: String!, $collapsed: Boolean!, $sortOrder: Int!) {
updateBookmarkGroup(id: $id, name: $name, collapsed: $collapsed, sortOrder: $sortOrder) { id name collapsed sortOrder itemCount createdAt updatedAt }
}bookmark
Leggere un segnalibro memorizzato tramite ID; restituire null se assente.
query bookmark($id: ID!) {
bookmark(id: $id) { id url title faviconPath groupId pinned clickCount sortOrder }
}bookmarkGroups
Elencare tutti i gruppi di segnalibri.
query bookmarkGroups {
bookmarkGroups { id name collapsed sortOrder itemCount createdAt updatedAt }
}bookmarks
Elencare tutti i segnalibri.
query bookmarks {
bookmarks { id url title faviconPath groupId pinned clickCount sortOrder }
}pageMetadata
Recuperare titolo e URL della favicon di una pagina web senza salvare un segnalibro.
query pageMetadata($url: String!) {
pageMetadata(url: $url) { title faviconUrl }
}bookmarksUpdated
Ricevere i record dei segnalibri aggiornati.
subscription bookmarksUpdated {
bookmarksUpdated { id url title faviconPath groupId pinned clickCount sortOrder }
}