Обновление принтера

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Обновление свойств объекта принтера .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальное обслуживание	Правительство США L4	Правительство США L5 (DOD)	Китай, обслуживаемый 21Vianet
✅	✅	✅	❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшим объемом привилегий	Разрешения с более высоким уровнем привилегий
Делегированные (рабочая или учебная учетная запись)	Printer.ReadWrite.All	Printer.FullControl.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Приложение	Printer.ReadWrite.All	Недоступно.

Примечание. В настоящее время только принтеры без физических устройств можно обновлять с использованием разрешений приложений.

HTTP-запрос

PATCH /print/printers/{id}

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.
Content-Type	`application/json` При использовании делегированных разрешений `application/ipp` или `application/json` при использовании разрешений приложений. Обязательно.

Текст запроса

Делегированные разрешения и полезные данные JSON

При использовании делегированных разрешений в тексте запроса укажите значения соответствующих полей принтера , которые необходимо обновить. Существующие свойства, не включенные в текст запроса, сохраняют свои прежние значения или пересчитываются на основе изменений других значений свойств. Для достижения оптимальной производительности не включайте существующие значения, которые не изменились.

Следующие свойства можно обновить с помощью делегированных разрешений.

Свойство	Тип	Описание
defaults	printerDefaults	Параметры печати принтера по умолчанию.
расположение	местоположение принтера	Физическое и организационное расположение принтера.
displayName	String	Имя принтера.

Разрешения приложений и полезные данные JSON

В тексте запроса введите значения соответствующих полей принтера , которые необходимо обновить. Существующие свойства, не включенные в текст запроса, сохраняют свои прежние значения или пересчитываются на основе изменений других значений свойств. Для достижения оптимальной производительности не включайте существующие значения, которые не изменились.

Следующие свойства можно обновлять с помощью разрешений приложения.

Свойство	Тип	Описание
defaults	printerDefaults	Параметры печати принтера по умолчанию.
capabilities	printerCapabilities	Возможности принтера, связанные с этим общим именем принтера.
displayName	String	Имя принтера.
manufacturer	String	Производитель принтера.
model	String	Название модели принтера.
status	printerStatus	Состояние обработки принтера, включая все ошибки.
isAcceptingJobs	Логический	Принимает ли принтер в данный момент новые задания печати.

Разрешения приложений и полезные данные IPP

При наличии разрешений приложения принтер также можно обновить, используя полезную нагрузку протокола печати через Интернет (IPP). В этом случае текст запроса содержит двоичный поток, представляющий группу "Атрибуты принтера" в кодировке IPP.

Клиент ДОЛЖЕН предоставить набор атрибутов принтера с одним или несколькими значениями (включая явно разрешенные внеплановые значения), как определено в RFC8011 разделе 5.2 Атрибуты шаблона задания (атрибуты xxx-default, «xxx-supported» и «xxx-ready»), раздел 5.4 Атрибуты описания принтера. Кроме того, клиент должен предоставить все расширения атрибутов, поддерживаемые принтером. Значения каждого предоставленного атрибута принтера заменяют значения соответствующего атрибута принтера целевого объекта принтера. Для атрибутов, которые могут иметь несколько значений (1setOf), все значения, предоставленные клиентом, заменяют все значения соответствующего атрибута объекта принтера.

Примечание. Не передавать атрибуты операции в тексте запроса. Текст запроса должен содержать только атрибуты принтера.

Примечание. Чтобы принтеры работали с определенной платформой, они должны соответствовать требованиям этой платформы. Например, в клиенте Windows ожидается, что принтер укажет все атрибуты, которые считаются обязательными в соответствии со спецификациями MOBRIA . Обратите внимание, что характеристики MOPRIA доступны только платным подписчикам MOPRIA.

Отклик

Делегированные разрешения и полезные данные JSON

При использовании делегированных разрешений, в случае успеха, этот метод возвращает код ответа 200 OK и обновленный объект принтера в тексте ответа.

Разрешения приложений и полезные данные JSON

Разрешения приложений и полезные данные IPP

При использовании разрешений приложения, в случае успеха, этот метод возвращает 204 No content код ответа. В тексте ответа ничего не возвращается.

Пример

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/beta/print/printers/{id}
Content-type: application/json

{
  "name": "PrinterName",
  "location": {
    "latitude": 1.1,
    "longitude": 2.2,
    "altitudeInMeters": 3
  }
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new Printer
{
	Name = "PrinterName",
	Location = new PrinterLocation
	{
		Latitude = 1.1d,
		Longitude = 2.2d,
		AltitudeInMeters = 3,
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Print.Printers["{printer-id}"].PatchAsync(requestBody);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewPrinter()
name := "PrinterName"
requestBody.SetName(&name) 
location := graphmodels.NewPrinterLocation()
latitude := float64(1.1)
location.SetLatitude(&latitude) 
longitude := float64(2.2)
location.SetLongitude(&longitude) 
altitudeInMeters := int32(3)
location.SetAltitudeInMeters(&altitudeInMeters) 
requestBody.SetLocation(location)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
printers, err := graphClient.Print().Printers().ByPrinterId("printer-id").Patch(context.Background(), requestBody, nil)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Printer printer = new Printer();
printer.setName("PrinterName");
PrinterLocation location = new PrinterLocation();
location.setLatitude(1.1d);
location.setLongitude(2.2d);
location.setAltitudeInMeters(3);
printer.setLocation(location);
Printer result = graphClient.print().printers().byPrinterId("{printer-id}").patch(printer);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const printer = {
  name: 'PrinterName',
  location: {
    latitude: 1.1,
    longitude: 2.2,
    altitudeInMeters: 3
  }
};

await client.api('/print/printers/{id}')
	.version('beta')
	.update(printer);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\Printer;
use Microsoft\Graph\Beta\Generated\Models\PrinterLocation;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new Printer();
$requestBody->setName('PrinterName');
$location = new PrinterLocation();
$location->setLatitude(1.1);
$location->setLongitude(2.2);
$location->setAltitudeInMeters(3);
$requestBody->setLocation($location);

$result = $graphServiceClient->escapedPrint()->printers()->byPrinterId('printer-id')->patch($requestBody)->wait();

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.printer import Printer
from msgraph_beta.generated.models.printer_location import PrinterLocation
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Printer(
	name = "PrinterName",
	location = PrinterLocation(
		latitude = 1.1,
		longitude = 2.2,
		altitude_in_meters = 3,
	),
)

result = await graph_client.print.printers.by_printer_id('printer-id').patch(request_body)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#print/printers/$entity",
  "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
  "displayName": "PrinterName",
  "manufacturer": "PrinterManufacturer",
  "model": "PrinterModel",
  "isShared": true,
  "registeredDateTime": "2020-02-04T00:00:00.0000000Z",
  "isAcceptingJobs": true,
  "status": {
    "state": "idle",
    "details": [],
    "description": ""
  },
  "defaults": {
    "copiesPerJob":1,
    "contentType": "application/oxps",
    "finishings": ["none"],
    "mediaType": "stationery"
  },
  "location": {
    "latitude": 1.1,
    "longitude": 2.2,
    "altitudeInMeters": 3,
    "streetAddress": "One Microsoft Way",
    "subUnit": [
        "Main Plaza",
        "Unit 400"
    ],
    "city": "Redmond",
    "postalCode": "98052",
    "countryOrRegion": "USA",
    "site": "Puget Sound",
    "building": "Studio E",
    "floor": "1",
    "floorDescription": "First Floor",
    "roomName": "1234",
    "roomDescription": "First floor copy room",
    "organization": [
        "C+AI",
        "Microsoft Graph"
    ],
    "subdivision": [
        "King County",
        "Red West"
    ],
    "stateOrProvince": "Washington"
  }
}

Обратная связь

Были ли сведения на этой странице полезными?

Последнее обновление: 2024-04-05

Обновление принтера

Разрешения

HTTP-запрос

Заголовки запросов

Текст запроса

Делегированные разрешения и полезные данные JSON

Разрешения приложений и полезные данные JSON

Разрешения приложений и полезные данные IPP

Отклик

Делегированные разрешения и полезные данные JSON

Разрешения приложений и полезные данные JSON

Разрешения приложений и полезные данные IPP

Пример

Запрос

Отклик

Обратная связь

Дополнительные ресурсы