Compartilhar via


educationSubmission: setUpResourcesFolder

Namespace: microsoft.graph

Acione a criação da pasta de recursos do SharePoint onde todos os recursos baseados em ficheiros (Word, Excel, etc.) devem ser carregados para uma determinada submissão. Apenas os professores e estudantes podem realizar esta operação.

Tenha em atenção que os ficheiros têm de estar localizados nesta pasta para serem adicionados como recursos. Apenas um estudante na turma pode determinar que ficheiros carregar numa determinada pasta de recursos ao nível da submissão.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) EduAssignments.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

POST /education/classes/{id}/assignments/{id}/submissions/{id}/setUpResourcesFolder

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório.

Corpo da solicitação

Forneça um json {} vazio como corpo do pedido para este método.

Resposta

Se tiver êxito, este método retornará um código de resposta 200 OK. O corpo irá conter o modelo de submissão.

Se a atribuição já estiver no estado submetido ou se a atribuição já não estiver aberta para submissão, este método devolve um 400 Bad Request código de resposta.

Exemplos

Exemplo 1: Configurar uma pasta de recursos para uma submissão

Solicitação

O exemplo seguinte mostra um pedido que aciona a criação de uma pasta de recursos do SharePoint para uma submissão.

Exemplo 1: Configurar uma pasta de recursos para uma submissão

Solicitação

O exemplo seguinte mostra um pedido que aciona a criação de uma pasta de recursos do SharePoint para uma submissão.

POST https://graph.microsoft.com/v1.0/education/classes/b07edbef-7420-4b3d-8f7c-d599cf21e069/assignments/222bd-b7d2-4d64-8a22-74b722ce2fc6/submissions/803fb5dd-3553-455f-3d94-f79fb54a1003/setUpResourcesFolder
Content-type: application/json

{
}

Resposta

O exemplo a seguir mostra a resposta.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('b07edbef-7420-4b3d-8f7c-d599cf21e069')/assignments('1e5222bd-b7d2-4d64-8a22-74b722ce2fc6')/submissions/$entity",
    "status": "working",
    "submittedDateTime": null,
    "unsubmittedDateTime": null,
    "returnedDateTime": null,
    "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!6SQl0y4WHkS2P5MeIsSGpKwfynEIaD1OvPVeH4wbOp_1uyhNwJMSSpseJneB7Z4F/items/01YT2AIJRQLVYT24IWWFAJHMRRNYCB3GE2",
    "id": "803fb5dd-3553-455f-3d94-f79fb54a1003",
    "recipient": {
        "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
        "userId": "f8bbb2a4-2cdd-4d49-ac81-d4113fc72dc1"
    },
    "submittedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": "f8bbb2a4-2cdd-4d49-ac81-d4113fc72dc1",
            "displayName": null
        }
    },
    "unsubmittedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": null,
            "displayName": null
        }
    },
    "returnedBy": {
        "application": null,
        "device": null,
        "user": {
            "id": null,
            "displayName": null
        }
    },
    "resources": [],
    "submittedResources": []
}

Exemplo 2: Configurar uma pasta de recursos quando a atribuição já não estiver aberta para submissão

Solicitação

O exemplo seguinte mostra um pedido que tenta configurar uma pasta de recursos, mas falha com um 400 Bad Request código de resposta porque a atribuição já não está aberta para submissão.

POST https://graph.microsoft.com/v1.0/education/classes/b07edbef-7420-4b3d-8f7c-d599cf21e069/assignments/1e5222bd-b7d2-4d64-8a22-74b722ce2fc6/submissions/803fb5dd-3553-455f-3d94-f79fb54a1003/setUpResourcesFolder
Content-type: application/json

{
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 400 Bad Request
Content-type: application/json

{
    "error": {
        "code": "badRequest",
        "message": "Bad request.",
        "innerError": {
            "code": "assignmentHasBeenSubmitted",
            "message": "Resource folder cannot be set up for assignments that are no longer open for submissions."
        }
    }
}

Exemplo 3: Configurar uma pasta de recursos quando a atribuição já estiver no estado submetido

Solicitação

O exemplo seguinte mostra um pedido que tenta configurar uma pasta de recursos, mas falha com um 400 Bad Request código de resposta porque a atribuição já foi submetida.

POST https://graph.microsoft.com/v1.0/education/classes/b07edbef-7420-4b3d-8f7c-d599cf21e069/assignments/1e5222bd-b7d2-4d64-8a22-74b722ce2fc6/submissions/803fb5dd-3553-455f-3d94-f79fb54a1003/setUpResourcesFolder
Content-type: application/json

{
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 400 Bad Request
Content-type: application/json

{
    "error": {
        "code": "badRequest",
        "message": "Bad request.",
        "innerError": {
            "code": "assignmentHasBeenSubmitted",
            "message": "Resource folder cannot be set up while the submission is in the submitted state."
        }
    }
}