Criar educationSubmissionResource

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Adicione um educationSubmissionResource a uma lista de recursos de envio.

Somente professores e alunos podem executar essa operação.

A operação não terá êxito se o sinalizador allowStudentsToAddResources não estiver definido como true.

Para criar um novo recurso baseado em arquivo, carregue o arquivo na pasta de recursos associada ao envio. Se o arquivo não existir ou não estiver nessa pasta, a solicitação POST falhará.

Importante

Antes de carregar um recurso de atribuição, você deve configurar a pasta de recursos para o educationAssignment para carregar os arquivos.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) EduAssignments.ReadWriteBasic EduAssignments.ReadWrite
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

POST /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submission-id}/resources

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do recurso. A seguir estão os tipos com suporte:

Nota: O educationExternalResource é apenas um recurso fora, você não pode POSTAR um envio com ele.

O assignmentResourceUrl não é necessário no corpo da solicitação, é uma propriedade somente leitura.

Resposta

Se for bem-sucedido, esse método retornará um 201 Created código de resposta e um objeto de acordo com o tipo de recurso no corpo da resposta.

Exemplos

Exemplo 1: Criar um educationWordResource

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b/submissions/4af73d2b-6b9c-493f-0688-979087bed39b/resources
Content-type: application/json

{
    "resource": {
        "@odata.type": "microsoft.graph.educationWordResource",
        "displayName": "Report.docx",
        "fileUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEELISJB7NVNVBAK7V4UIF6Q27U2"
    }
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('f4a941ff-9da6-4707-ba5b-0eae93cad0b4')/assignments('3c77de7f-539b-49e1-9c96-1274f2f0ee3b')/submissions('4af73d2b-6b9c-493f-0688-979087bed39b')/resources/$entity",
    "assignmentResourceUrl": null,
    "id": "d835503f-fd00-4840-b69c-7230d10e18b8",
    "resource": {
        "@odata.type": "#microsoft.graph.educationWordResource",
        "displayName": "Report.docx",
        "createdDateTime": "2021-08-04T00:23:08.6269586Z",
        "lastModifiedDateTime": "2021-08-04T00:23:08.6269586Z",
        "fileUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEELISJB7NVNVBAK7V4UIF6Q27U2",
        "createdBy": {
            "application": null,
            "device": null,
            "user": {
                "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
                "displayName": null
            }
        },
        "lastModifiedBy": {
            "application": null,
            "device": null,
            "user": {
                "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
                "displayName": null
            }
        }
    }
}

Exemplo 2: Criar um educationLinkResource

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/1618dfb0-3ff2-4edf-8d5c-b8f81df00e80/submissions/da443246-384d-673b-32db-bdba9d7f2b51/resources
Content-type: application/json

{
	"resource": {
		"displayName": "Wikipedia",
		"link": "https://en.wikipedia.org/wiki/Main_Page",
		"@odata.type": "#microsoft.graph.educationLinkResource"
	}
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
	"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('1618dfb0-3ff2-4edf-8d5c-b8f81df00e80')/submissions('da443246-384d-673b-32db-bdba9d7f2b51')/resources/$entity",
	"assignmentResourceUrl": null,
	"id": "88b441b0-cb05-45ab-a0f0-139f978e0993",
	"resource": {
		"@odata.type": "#microsoft.graph.educationLinkResource",
		"displayName": "Wikipedia",
		"createdDateTime": "2021-09-13T19:20:46.0648354Z",
		"lastModifiedDateTime": "2021-09-13T19:20:46.0648354Z",
		"link": "https://en.wikipedia.org/wiki/Main_Page",
		"createdBy": {
			"application": null,
			"device": null,
			"user": {
				"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
				"displayName": null
			}
		},
		"lastModifiedBy": {
			"application": null,
			"device": null,
			"user": {
				"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
				"displayName": null
			}
		}
	}
}

Exemplo 3: Criar um educationFileResource

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/1618dfb0-3ff2-4edf-8d5c-b8f81df00e80/submissions/da443246-384d-673b-32db-bdba9d7f2b51/resources
Content-type: application/json

{
	"resource": {
		"displayName": "_FTP_EDC-61424749-250820211136.pdf",
		"fileUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RL45XVPGDBRW5FLDR62Z5TCMGG3",
		"@odata.type": "#microsoft.graph.educationFileResource"
	}
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
	"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('1618dfb0-3ff2-4edf-8d5c-b8f81df00e80')/submissions('da443246-384d-673b-32db-bdba9d7f2b51')/resources/$entity",
	"assignmentResourceUrl": null,
	"id": "33cf3eb2-8a35-4f76-8f16-b2abc112d44f",
	"resource": {
		"@odata.type": "#microsoft.graph.educationFileResource",
		"displayName": "_FTP_EDC-61424749-250820211136.pdf",
		"createdDateTime": "2021-09-13T19:23:04.5049139Z",
		"lastModifiedDateTime": "2021-09-13T19:23:04.5049139Z",
		"fileUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RL45XVPGDBRW5FLDR62Z5TCMGG3",
		"createdBy": {
			"application": null,
			"device": null,
			"user": {
				"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
				"displayName": null
			}
		},
		"lastModifiedBy": {
			"application": null,
			"device": null,
			"user": {
				"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
				"displayName": null
			}
		}
	}
}

Exemplo 4: Criar um educationExcelResource

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/1618dfb0-3ff2-4edf-8d5c-b8f81df00e80/submissions/da443246-384d-673b-32db-bdba9d7f2b51/resources
Content-type: application/json

{
	"resource": {
		"@odata.type": "#microsoft.graph.educationExcelResource",
		"displayName": "userAgeGroup QueryParameter Test.xlsx",
		"fileUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RONPUDM2CZKNRF3TGHYUM7Z64WE"
	}
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
	"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('1618dfb0-3ff2-4edf-8d5c-b8f81df00e80')/submissions('da443246-384d-673b-32db-bdba9d7f2b51')/resources/$entity",
	"assignmentResourceUrl": null,
	"id": "c36626ba-9864-4f3a-8d6f-7104f62df605",
	"resource": {
		"@odata.type": "#microsoft.graph.educationExcelResource",
		"displayName": "userAgeGroup QueryParameter Test.xlsx",
		"createdDateTime": "2021-09-13T19:23:58.3925618Z",
		"lastModifiedDateTime": "2021-09-13T19:23:58.3925618Z",
		"fileUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RONPUDM2CZKNRF3TGHYUM7Z64WE",
		"createdBy": {
			"application": null,
			"device": null,
			"user": {
				"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
				"displayName": null
			}
		},
		"lastModifiedBy": {
			"application": null,
			"device": null,
			"user": {
				"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
				"displayName": null
			}
		}
	}
}

Exemplo 5: Criar um educationPowerPointResource

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/1618dfb0-3ff2-4edf-8d5c-b8f81df00e80/submissions/da443246-384d-673b-32db-bdba9d7f2b51/resources
Content-type: application/json

{
	"resource": {
		"@odata.type": "#microsoft.graph.educationPowerPointResource",
		"displayName": "state diagram.pptx",
		"fileUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RN3MHWWM7BNXJD2UD5OMRFEDKN2"
	}
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
	"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('1618dfb0-3ff2-4edf-8d5c-b8f81df00e80')/submissions('da443246-384d-673b-32db-bdba9d7f2b51')/resources/$entity",
	"assignmentResourceUrl": null,
	"id": "e19bd829-17ee-4483-88d0-f62b406f367c",
	"resource": {
		"@odata.type": "#microsoft.graph.educationPowerPointResource",
		"displayName": "state diagram.pptx",
		"createdDateTime": "2021-09-13T19:24:38.4706263Z",
		"lastModifiedDateTime": "2021-09-13T19:24:38.4706263Z",
		"fileUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RN3MHWWM7BNXJD2UD5OMRFEDKN2",
		"createdBy": {
			"application": null,
			"device": null,
			"user": {
				"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
				"displayName": null
			}
		},
		"lastModifiedBy": {
			"application": null,
			"device": null,
			"user": {
				"id": "80cefd93-8d88-40e2-b5d3-67898383e226",
				"displayName": null
			}
		}
	}
}

Exemplo 6: Criar um educationMediaResource

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/1618dfb0-3ff2-4edf-8d5c-b8f81df00e80/submissions/da443246-384d-673b-32db-bdba9d7f2b51/resources
Content-type: application/json

{
	"resource": {
		"displayName": "category.jpg",
		"fileUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RK2WLKUUBAA4ZBKXNBL6QFC2TKG",
		"@odata.type": "#microsoft.graph.educationMediaResource"
	}
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('1618dfb0-3ff2-4edf-8d5c-b8f81df00e80')/submissions('da443246-384d-673b-32db-bdba9d7f2b51')/resources/$entity",
    "assignmentResourceUrl": null,
    "id": "31f2c67a-6df1-4a7f-b4c5-311fe15c873a",
    "resource": {
        "@odata.type": "#microsoft.graph.educationMediaResource",
        "displayName": "category.jpg",
        "createdDateTime": "2021-09-16T19:07:59.4982929Z",
        "lastModifiedDateTime": "2021-09-16T19:07:59.4982929Z",
        "fileUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RK2WLKUUBAA4ZBKXNBL6QFC2TKG",
        "createdBy": {
            "application": null,
            "device": null,
            "user": {
                "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
                "displayName": null
            }
        },
        "lastModifiedBy": {
            "application": null,
            "device": null,
            "user": {
                "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
                "displayName": null
            }
        }
    }
}