プリンターを更新する

[アーティクル]
01/31/2024

名前空間: microsoft.graph

プリンターオブジェクトのプロパティを更新します。

この API は、次の国内クラウド展開で使用できます。

グローバルサービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	✅	✅	❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。これらのアクセス許可の詳細については、アクセス許可のリファレンスを参照してください。

アクセス許可の種類	最小特権アクセス許可	特権の高いアクセス許可
委任 (職場または学校のアカウント)	Printer.ReadWrite.All	Printer.FullControl.All
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	Printer.ReadWrite.All	注意事項なし。

HTTP 要求

PATCH /print/printers/{printerId}

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須です。認証と承認の詳細については、こちらをご覧ください。
Content-type	`application/json` 委任されたアクセス許可を使用する場合、 `application/ipp` または `application/json` アプリケーションのアクセス許可を使用する場合。必須です。

要求本文

委任されたアクセス許可と JSON ペイロード

委任されたアクセス許可を使用する場合は、要求本文で、更新する必要がある関連するプリンターフィールドの値を指定します。要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。最適なパフォーマンスを得るために、変更されていない既存の値を含めないでください。

委任されたアクセス許可を使用して、次のプロパティを更新できます。

プロパティ	型	説明
既定	printerDefaults	プリンターの既定の印刷設定。
場所	printerLocation	プリンターの物理的または組織の場所。
displayName	String	プリンターの名前。

アプリケーションのアクセス許可と JSON ペイロード

要求本文で、更新する必要がある関連プリンターフィールドの値を指定します。要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。最適なパフォーマンスを得るために、変更されていない既存の値を含めないでください。

次のプロパティは、アプリケーションのアクセス許可を使用して更新できます。

プロパティ	型	説明
既定	printerDefaults	プリンターの既定の印刷設定。
capabilities	printerCapabilities	このプリンター共有に関連付けられているプリンターの機能。
displayName	String	プリンターの名前。
manufacturer	String	プリンターの製造元。
model	String	プリンターのモデル名。
status	printerStatus	エラーを含むプリンターの処理状態。
isAcceptingJobs	ブール型	プリンターが現在新しい印刷ジョブを受け入れているかどうか。

アプリケーションのアクセス許可と IPP ペイロード

アプリケーションのアクセス許可を使用すると、インターネット印刷プロトコル (IPP) ペイロードを使用してプリンターを更新することもできます。この場合、要求本文には、IPP エンコードのプリンター属性グループを表すバイナリストリームが含まれています。

クライアントは、セクション 5.2 ジョブテンプレート属性 ("xxx-default"、"xxx-supported"、および "xxx-ready" 属性) RFC8011 で定義されている 1 つ以上の値 (明示的に許可された帯域外の値を含む) を持つプリンター属性のセットを指定する必要があります。セクション 5.4 プリンター記述属性。クライアントは、プリンターでサポートされている属性拡張機能も指定する必要があります。指定された各 Printer 属性の値は、ターゲット Printer オブジェクトの対応する Printer 属性の値を置き換えます。複数の値 (1setOf) を持つ属性の場合、クライアントによって指定されたすべての値は、対応する Printer オブジェクト属性のすべての値を置き換えます。

応答

委任されたアクセス許可と JSON ペイロード

委任されたアクセス許可を使用している場合、成功した場合、このメソッドは応答コードと更新されたプリンターオブジェクトを応答本文に返200 OKします。

アプリケーションのアクセス許可と JSON ペイロード

アプリケーションのアクセス許可と IPP ペイロード

アプリケーションのアクセス許可を使用している場合、成功した場合、このメソッドは応答コードを 204 No content 返します。応答本文では何も返されません。

例

要求

次の例は要求を示しています。

PATCH https://graph.microsoft.com/v1.0/print/printers/{printerId}
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.Models;

var requestBody = new Printer
{
	Location = new PrinterLocation
	{
		Latitude = 1.1d,
		Longitude = 2.2d,
		AltitudeInMeters = 3,
	},
	AdditionalData = new Dictionary<string, object>
	{
		{
			"name" , "PrinterName"
		},
	},
};

// 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);



mgc print printers patch --printer-id {printer-id} --body '{\
  "name": "PrinterName",\
  "location": {\
    "latitude": 1.1,\
    "longitude": 2.2,\
    "altitudeInMeters": 3\
  }\
}\
'



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

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

requestBody := graphmodels.NewPrinter()
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)
additionalData := map[string]interface{}{
	"name" : "PrinterName", 
}
requestBody.SetAdditionalData(additionalData)

// 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)


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Printer printer = new Printer();
PrinterLocation location = new PrinterLocation();
location.setLatitude(1.1d);
location.setLongitude(2.2d);
location.setAltitudeInMeters(3);
printer.setLocation(location);
HashMap<String, Object> additionalData = new HashMap<String, Object>();
additionalData.put("name", "PrinterName");
printer.setAdditionalData(additionalData);
Printer result = graphClient.print().printers().byPrinterId("{printer-id}").patch(printer);


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/{printerId}')
	.update(printer);


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


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

$requestBody = new Printer();
$location = new PrinterLocation();
$location->setLatitude(1.1);
$location->setLongitude(2.2);
$location->setAltitudeInMeters(3);
$requestBody->setLocation($location);
$additionalData = [
	'name' => 'PrinterName',
];
$requestBody->setAdditionalData($additionalData);

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


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.printer import Printer
from msgraph.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(
	location = PrinterLocation(
		latitude = 1.1,
		longitude = 2.2,
		altitude_in_meters = 3,
	),
	additional_data = {
			"name" : "PrinterName",
	}
)

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

応答

次の例は応答を示しています。注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$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"
  }
}

次の方法で共有

プリンターを更新する

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

委任されたアクセス許可と JSON ペイロード

アプリケーションのアクセス許可と JSON ペイロード

アプリケーションのアクセス許可と IPP ペイロード

応答

委任されたアクセス許可と JSON ペイロード

アプリケーションのアクセス許可と JSON ペイロード

アプリケーションのアクセス許可と IPP ペイロード

例

要求

応答

フィードバック

その他のリソース