Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph.search
Обновление свойств объекта закладки .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | SearchConfiguration.Read.All | SearchConfiguration.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | SearchConfiguration.Read.All | SearchConfiguration.ReadWrite.All |
HTTP-запрос
PATCH /search/bookmarks/{bookmarksId}
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите только значения свойств для обновления. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.
В следующей таблице указаны свойства, которые можно обновить.
Заметка: Любые обновления свойств коллекции, такие как ключевые слова или категории, заменяют всю коллекцию.
| Свойство | Тип | Описание |
|---|---|---|
| availabilityEndDateTime | DateTimeOffset | Дата и время прекращения отображения закладки в качестве результата поиска. Задайте значение null для параметра always available. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| availabilityStartDateTime | DateTimeOffset | Дата и время начала отображения закладки в качестве результата поиска. Задайте значение null для параметра always available. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. |
| categories | Коллекция String | Категории, часто используемые для описания этой закладки. Например, IT и HR. |
| description | String | Описание закладки, которое отображается на странице результатов поиска. Наследуется от searchAnswer. |
| displayName | String | Имя закладки, отображаемое в результатах поиска. Наследуется от searchAnswer. |
| groupIds | Коллекция строк | Список групп безопасности, которые могут просматривать эту закладку. |
| keywords | microsoft.graph.search.answerKeyword | Ключевые слова, запускающие эту закладку, отображаются в результатах поиска. |
| languageTags | Коллекция строк | Список географически определенных языковых имен, на которых можно просматривать эту закладку. Каждое значение тега языка соответствует шаблону {language}-{region}. Например, является английским языкомen-us, используемым в США. Список возможных значений см. в разделе Поддерживаемые теги языка. |
| Платформ | Коллекция microsoft.graph.devicePlatformType | Список устройств и операционных систем, которые могут просматривать эту закладку. Возможные значения: android, , androidForWork, iosmacOS, windowsPhone81, , windowsPhone81AndLater, windows10AndLater, androidWorkProfile, unknown, androidASOP, androidMobileApplicationManagement, iOSMobileApplicationManagement, , . unknownFutureValue |
| powerAppIds | Коллекция строк | Список Приложений Power Apps, связанных с этой закладкой. Если пользователи добавляют существующие Приложения Power Apps в закладку, они могут выполнять задачи непосредственно на странице результатов поиска, например вводить время отпуска или отчеты о расходах. |
| state | microsoft.graph.search.answerState | Состояние закладки. Допустимые значения: published, draft, excluded, unknownFutureValue. |
| targetedVariations | коллекция microsoft.graph.search.answerVariant | Варианты закладки для разных стран или регионов или устройств. Используйте, когда необходимо отобразить пользователям разное содержимое в зависимости от их устройства, страны или региона или обоих вариантов. Параметры даты и группы применяются ко всем вариантам. |
| webUrl | String | ССЫЛКА НА URL-адрес закладки. Когда пользователи выбирают эту закладку в результатах поиска, они направляются по указанному URL-адресу. Наследуется от searchAnswer. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 204 No Content.
Примеры
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/v1.0/search/bookmarks/733b26d5-af76-4eea-ac69-1a0ce8716897
Content-Type: application/json
{
"description": "Book a fancy vacation in Tuscany or browse museums in Florence."
}
Отклик
Ниже приводится пример отклика.
HTTP/1.1 204 No Content