Skip to content

Commit 4458a5a

Browse files
FaithOmbongiFaithOmbongi
authored
Merge pull request #26248 from microsoftgraph/users/carlape/airprint-printsettings
Add AirPrint setting to printSettings v1.0
2 parents 2c50882 + 6683e0a commit 4458a5a

File tree

12 files changed

+195
-59
lines changed

12 files changed

+195
-59
lines changed

‎api-reference/beta/api/print-update-settings.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,13 +39,14 @@ In the request body, supply the values for the relevant [printSettings](../resou
3939

4040
| Property | Type | Description |
4141
|:-------------|:------------|:------------|
42-
|documentConversionEnabled|Boolean|Specifies whether document conversion is enabled for the tenant. If document conversion is enabled, Universal Print service will automatically convert documents into a format compatible with the printer (for example, XPS to PDF) when needed.|
42+
|documentConversionEnabled|Boolean|Specifies whether document conversion is enabled for the tenant. If document conversion is enabled, Universal Print service automatically converts documents into a format compatible with the printer (for example, XPS to PDF) when needed.|
43+
|printerDiscoverySettings|[printerDiscoverySettings](../resources/printerdiscoverysettings.md)|Specifies settings that affect printer discovery when using Universal Print.|
4344

4445
## Response
4546
If successful, this method returns a `204 No Content` response code and an empty response body.
4647

4748
## Example
48-
##### Request
49+
### Request
4950
The following example shows a request.
5051

5152
# [HTTP](#tab/http)
@@ -68,7 +69,7 @@ Content-type: application/json
6869

6970
---
7071

71-
##### Response
72+
### Response
7273
The following example shows the response.
7374
<!-- {
7475
"blockType": "response"

‎api-reference/beta/resources/airprintsettings.md

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: airPrintSettings resource type
3-
description: Represents tenant-wide settings to configure the behavior of printers when print jobs are submitted to Universal Print from macOS, which requires AirPrint compatibility.
4-
author: JuliusShanMS
2+
title: "airPrintSettings resource type"
3+
description: "Represents tenant-wide settings to configure the behavior of printers when print jobs are submitted to Universal Print from macOS, which requires AirPrint compatibility."
4+
author: "JuliusShanMS"
55
ms.localizationpriority: medium
6-
ms.subservice: universal-print
6+
ms.subservice: "universal-print"
77
doc_type: resourcePageType
8-
ms.date: 03/06/2024
8+
ms.date: "03/06/2024"
99
---
1010

1111
# airPrintSettings resource type
@@ -16,18 +16,21 @@ Namespace: microsoft.graph
1616

1717
Represents tenant-wide settings to configure the behavior of printers when print jobs are submitted to Universal Print from macOS, which requires AirPrint compatibility.
1818

19+
> [!NOTE]
20+
> **AirPrint**, **Mac**, and **macOS** are trademarks of Apple, Inc., registered in the US and other countries/regions.
21+
1922
## Properties
2023
|Property|Type|Description|
2124
|:---|:---|:---|
2225
|incompatiblePrinters|[incompatiblePrinterSettings](#incompatibleprintersettings-values)|Describes whether Universal Print hides printers from macOS when they don't support all capabilities required by the operating system as defined by AirPrint.|
2326

2427
### incompatiblePrinterSettings values
2528

26-
|Member|Value|Description|
27-
|:---|:---|:---|
28-
|show|0|Show printers that aren't compatible with AirPrint.|
29-
|hide|1|Hide printers that aren't compatible with AirPrint.|
30-
|unknownFutureValue|2|Evolvable enumeration sentinel value. Don't use.|
29+
|Member|Description|
30+
|:---|:---|
31+
|show|Show printers that aren't compatible with AirPrint.|
32+
|hide|Hide printers that aren't compatible with AirPrint.|
33+
|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.|
3134

3235
## Relationships
3336
None.
@@ -41,10 +44,6 @@ The following JSON shows a representation of the resource.
4144
-->
4245
``` json
4346
{
44-
"incompatiblePrinters": "string"
47+
"incompatiblePrinters": "String"
4548
}
4649
```
47-
48-
### Credit notice
49-
50-
**AirPrint**, **Mac**, and **macOS** are trademarks of Apple, Inc., registered in the US and other countries/regions.

‎api-reference/beta/resources/printerdiscoverysettings.md

Lines changed: 9 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: printerDiscoverySettings resource type
3-
description: Represents tenant-wide printer discovery settings for the Universal Print service.
4-
author: JuliusShanMS
2+
title: "printerDiscoverySettings resource type"
3+
description: "Represents tenant-wide printer discovery settings for the Universal Print service."
4+
author: "JuliusShanMS"
55
ms.localizationpriority: medium
6-
ms.subservice: universal-print
6+
ms.subservice: "universal-print"
77
doc_type: resourcePageType
8-
ms.date: 03/06/2024
8+
ms.date: "03/06/2024"
99
---
1010

1111
# printerDiscoverySettings resource type
@@ -16,6 +16,9 @@ Namespace: microsoft.graph
1616

1717
Represents tenant-wide printer discovery settings for the Universal Print service.
1818

19+
> [!NOTE]
20+
> **AirPrint**, **Mac**, and **macOS** are trademarks of Apple, Inc., registered in the US and other countries/regions.
21+
1922
## Properties
2023
|Property|Type|Description|
2124
|:---|:---|:---|
@@ -34,12 +37,6 @@ The following JSON shows a representation of the resource.
3437
``` json
3538
{
3639
"@odata.type": "#microsoft.graph.printerDiscoverySettings",
37-
"airPrint": {
38-
"@odata.type": "microsoft.graph.airPrintSettings"
39-
}
40+
"airPrint": {"@odata.type": "microsoft.graph.airPrintSettings"}
4041
}
4142
```
42-
43-
### Credit notice
44-
45-
**AirPrint**, **Mac**, and **macOS** are trademarks of Apple, Inc., registered in the US and other countries/regions.

‎api-reference/beta/resources/printsettings.md

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: printSettings resource type
3-
description: Represents tenant-wide settings for the Universal Print service.
4-
author: braedenp-msft
2+
title: "printSettings resource type"
3+
description: "Represents tenant-wide settings for the Universal Print service."
4+
author: "braedenp-msft"
55
ms.localizationpriority: medium
6-
ms.subservice: universal-print
6+
ms.subservice: "universal-print"
77
doc_type: resourcePageType
8-
ms.date: 07/23/2024
8+
ms.date: "07/23/2024"
99
---
1010

1111
# printSettings resource type
@@ -16,6 +16,9 @@ Namespace: microsoft.graph
1616

1717
Represents tenant-wide settings for the Universal Print service.
1818

19+
> [!NOTE]
20+
> **AirPrint**, **Mac**, and **macOS** are trademarks of Apple, Inc., registered in the US and other countries/regions.
21+
1922
## Properties
2023
| Property | Type | Description |
2124
|:-------------|:------------|:------------|
@@ -39,13 +42,7 @@ The following JSON shows a representation of the resource.
3942

4043
```json
4144
{
42-
"documentConversionEnabled": true,
43-
"printerDiscoverySettings": {
44-
"@odata.type": "microsoft.graph.printerDiscoverySettings"
45-
}
45+
"documentConversionEnabled": "Boolean",
46+
"printerDiscoverySettings": {"@odata.type": "microsoft.graph.printerDiscoverySettings"}
4647
}
4748
```
48-
49-
## Credit notice
50-
51-
**AirPrint**, **Mac**, and **macOS** are trademarks of Apple, Inc., registered in the US and other countries/regions.

‎api-reference/v1.0/api/print-update-settings.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,8 @@ In the request body, supply the values for the relevant [printSettings](../resou
4040

4141
| Property | Type | Description |
4242
|:-------------|:------------|:------------|
43-
|documentConversionEnabled|Boolean|Specifies whether document conversion is enabled for the tenant. If document conversion is enabled, Universal Print service will automatically convert documents into a format compatible with the printer (for example, XPS to PDF) when needed.|
43+
|documentConversionEnabled|Boolean|Specifies whether document conversion is enabled for the tenant. If document conversion is enabled, Universal Print service automatically converts documents into a format compatible with the printer (for example, XPS to PDF) when needed.|
44+
|printerDiscoverySettings|[printerDiscoverySettings](../resources/printerdiscoverysettings.md)|Specifies settings that affect printer discovery when using Universal Print.|
4445

4546
## Response
4647

‎api-reference/v1.0/resources/airprintsettings.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: "airPrintSettings resource type"
3+
description: "Represents tenant-wide settings to configure the behavior of printers when print jobs are submitted to Universal Print from macOS, which requires AirPrint compatibility."
4+
author: "carlapgavilan"
5+
ms.localizationpriority: medium
6+
ms.subservice: "universal-print"
7+
doc_type: resourcePageType
8+
ms.date: "02/12/2025"
9+
---
10+
11+
# airPrintSettings resource type
12+
13+
Namespace: microsoft.graph
14+
15+
Represents tenant-wide settings to configure the behavior of printers when print jobs are submitted to Universal Print from macOS, which requires AirPrint compatibility.
16+
17+
> [!NOTE]
18+
> **AirPrint**, **Mac**, and **macOS** are trademarks of Apple, Inc., registered in the US and other countries/regions.
19+
20+
## Properties
21+
|Property|Type|Description|
22+
|:---|:---|:---|
23+
|incompatiblePrinters|[incompatiblePrinterSettings](#incompatibleprintersettings-values)|Describes whether Universal Print hides printers from macOS when they don't support all capabilities required by the operating system as defined by AirPrint.|
24+
25+
### incompatiblePrinterSettings values
26+
27+
|Member|Description|
28+
|:---|:---|
29+
|show|Show printers that aren't compatible with AirPrint.|
30+
|hide|Hide printers that aren't compatible with AirPrint.|
31+
|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.|
32+
33+
## Relationships
34+
None.
35+
36+
## JSON representation
37+
The following JSON shows a representation of the resource.
38+
<!-- {
39+
"blockType": "resource",
40+
"@odata.type": "microsoft.graph.airPrintSettings"
41+
}
42+
-->
43+
``` json
44+
{
45+
"incompatiblePrinters": "String"
46+
}
47+
```

‎api-reference/v1.0/resources/printerdiscoverysettings.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: "printerDiscoverySettings resource type"
3+
description: "Represents tenant-wide printer discovery settings for the Universal Print service."
4+
author: "carlapgavilan"
5+
ms.localizationpriority: medium
6+
ms.subservice: "universal-print"
7+
doc_type: resourcePageType
8+
ms.date: "02/12/2025"
9+
---
10+
11+
# printerDiscoverySettings resource type
12+
13+
Namespace: microsoft.graph
14+
15+
Represents tenant-wide printer discovery settings for the Universal Print service.
16+
17+
> [!NOTE]
18+
> **AirPrint**, **Mac**, and **macOS** are trademarks of Apple, Inc., registered in the US and other countries/regions.
19+
20+
## Properties
21+
|Property|Type|Description|
22+
|:---|:---|:---|
23+
|airPrint|[airPrintSettings](../resources/airprintsettings.md)|Represents tenant-wide settings to configure the behavior of printers when print jobs are submitted to Universal Print from macOS, which requires AirPrint compatibility.|
24+
25+
## Relationships
26+
None.
27+
28+
## JSON representation
29+
The following JSON shows a representation of the resource.
30+
<!-- {
31+
"blockType": "resource",
32+
"@odata.type": "microsoft.graph.printerDiscoverySettings"
33+
}
34+
-->
35+
``` json
36+
{
37+
"@odata.type": "#microsoft.graph.printerDiscoverySettings",
38+
"airPrint": {"@odata.type": "microsoft.graph.airPrintSettings"}
39+
}
40+
```

‎api-reference/v1.0/resources/printsettings.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: printSettings resource type
3-
description: Represents tenant-wide settings for the Universal Print service.
4-
author: nilakhan
2+
title: "printSettings resource type"
3+
description: "Represents tenant-wide settings for the Universal Print service."
4+
author: "nilakhan"
55
ms.localizationpriority: medium
6-
ms.subservice: universal-print
6+
ms.subservice: "universal-print"
77
doc_type: resourcePageType
8-
ms.date: 08/08/2024
8+
ms.date: "08/08/2024"
99
---
1010

1111
# printSettings resource type
@@ -17,7 +17,8 @@ Represents tenant-wide settings for the Universal Print service.
1717
## Properties
1818
|Property|Type|Description|
1919
|:---|:---|:---|
20-
|documentConversionEnabled|Boolean|Specifies whether document conversion is enabled for the tenant. If document conversion is enabled, Universal Print service will automatically convert documents into a format compatible with the printer (xps to pdf) when needed.|
20+
|documentConversionEnabled|Boolean|Specifies whether document conversion is enabled for the tenant. If document conversion is enabled, Universal Print service converts documents into a format compatible with the printer (xps to pdf) when needed.|
21+
|printerDiscoverySettings|[printerDiscoverySettings](../resources/printerdiscoverysettings.md)|Specifies settings that affect printer discovery when using Universal Print.|
2122

2223
## Relationships
2324

@@ -29,13 +30,14 @@ The following JSON representation shows the resource type.
2930

3031
<!-- {
3132
"blockType": "resource",
33+
"optionalProperties": [
34+
35+
],
3236
"@odata.type": "microsoft.graph.printSettings"
33-
}
34-
-->
35-
``` json
37+
}-->
38+
```json
3639
{
37-
"@odata.type": "#microsoft.graph.printSettings",
38-
"documentConversionEnabled": "Boolean"
40+
"documentConversionEnabled": "Boolean",
41+
"printerDiscoverySettings": {"@odata.type": "microsoft.graph.printerDiscoverySettings"}
3942
}
40-
```
41-
43+
```

‎api-reference/v1.0/toc/device-and-app-management/toc.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -370,6 +370,8 @@ items:
370370
href: ../../api/reports-getprinterarchivedprintjobs.md
371371
- name: Complex types
372372
items:
373+
- name: Air print settings
374+
href: ../../resources/airprintsettings.md
373375
- name: App identity
374376
href: ../../resources/appidentity.md
375377
- name: Archived print job
@@ -398,6 +400,8 @@ items:
398400
href: ../../resources/printercapabilities.md
399401
- name: Printer defaults
400402
href: ../../resources/printerdefaults.md
403+
- name: Printer discovery settings
404+
href: ../../resources/printerdiscoverysettings.md
401405
- name: Printer location
402406
href: ../../resources/printerlocation.md
403407
- name: Printer share viewpoint

‎api-reference/v1.0/toc/toc.mapping.json

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -386,6 +386,7 @@
386386
"printerShare"
387387
],
388388
"complexTypes": [
389+
"airPrintSettings",
389390
"appIdentity",
390391
"archivedPrintJob",
391392
"identity",
@@ -400,6 +401,7 @@
400401
"printTaskStatus",
401402
"printerCapabilities",
402403
"printerDefaults",
404+
"printerDiscoverySettings",
403405
"printerLocation",
404406
"printerShareViewpoint",
405407
"printerStatus",

0 commit comments

Comments
 (0)