Créer printTaskTrigger

Espace de noms: microsoft.graph

Créez un déclencheur de tâche sur l’imprimante spécifiée. Actuellement, un seul déclencheur de tâche peut être spécifié par imprimante, mais cette limite peut être supprimée à l’avenir.

Remarque : L’appId utilisé pour générer un jeton d’accès pour la création d’un déclencheur de tâche doit être le même que celui utilisé pour créer la définition de tâche correspondante.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Outre les autorisations suivantes, le client de l’utilisateur doit avoir un abonnement d’impression universelle actif. L’utilisateur doit être un administrateur d’imprimantes.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	Printer.ReadWrite.All, Printer.FullControl.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	Non prise en charge.

Requête HTTP

POST /print/printers/{printerId}/taskTriggers

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire.
Content-Type	application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissons une représentation JSON d’un objet printTaskTrigger . Fournissez une référence à un printTaskDefinition en utilisant le @odata.bind format, comme illustré dans l’exemple suivant.

Réponse

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un printTaskTrigger dans le corps de la réponse.

Exemples

Demande

HTTP

POST https://graph.microsoft.com/v1.0/print/printers/{printerId}/taskTriggers
Content-Type: application/json

{
  "event": "jobStarted",
  "definition@odata.bind": "https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}"
}

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var printTaskTrigger = new PrintTaskTrigger
{
    Event = PrintEvent.JobStarted,
    AdditionalData = new Dictionary<string, object>()
    {
        {"definition@odata.bind", "https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}"}
    }
};

await graphClient.Print.Printers["{printer-id}"].TaskTriggers
    .Request()
    .AddAsync(printTaskTrigger);

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const printTaskTrigger = {
  event: 'jobStarted',
  'definition@odata.bind': 'https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}'
};

await client.api('/print/printers/{printerId}/taskTriggers')
    .post(printTaskTrigger);

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/print/printers/{printerId}/taskTriggers"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphPrintTaskTrigger *printTaskTrigger = [[MSGraphPrintTaskTrigger alloc] init];
[printTaskTrigger setEvent: [MSGraphPrintEvent jobStarted]];

NSError *error;
NSData *printTaskTriggerData = [printTaskTrigger getSerializedDataWithError:&error];
[urlRequest setHTTPBody:printTaskTriggerData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

PrintTaskTrigger printTaskTrigger = new PrintTaskTrigger();
printTaskTrigger.event = PrintEvent.JOB_STARTED;
printTaskTrigger.additionalDataManager().put("definition@odata.bind", new JsonPrimitive("https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}"));

graphClient.print().printers("{printerId}").taskTriggers()
    .buildRequest()
    .post(printTaskTrigger);

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewPrintTaskTrigger()
event := "jobStarted"
requestBody.SetEvent(&event)
requestBody.SetAdditionalData(map[string]interface{}{
    "definition@odata.bind": "https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}",
}
printerId := "printer-id"
result, err := graphClient.Print().PrintersById(&printerId).TaskTriggers().Post(requestBody)

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

PowerShell

Import-Module Microsoft.Graph.Devices.CloudPrint

$params = @{
    Event = "jobStarted"
    "Definition@odata.bind" = "https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}"
}

New-MgPrintPrinterTaskTrigger -PrinterId $printerId -BodyParameter $params

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "https://graph.print.microsoft.com/v1.0/$metadata#Collection(Microsoft.Graph.PrintTaskTrigger)",
  "id": "b6a843ca-e60e-4e20-a222-a58d85eead6d",
  "event": "jobStarted"
}