Crear planContextLink

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Crear un nuevo objeto planContextLink.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permiso con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	No admitida.	No admitida.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	No admitida.	No admitida.

Solicitud HTTP

POST /me/planner/plans_v2/{planId}/contexts
POST /users/{usersId}/planner/plans_v2/{planId}/contexts

Encabezados de solicitud

Nombre	Descripción
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type	application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto planContextLink .

Puede especificar las siguientes propiedades al crear un planContextLink.

Propiedad	Tipo	Descripción
clave	Cadena	Identificador del contexto en el que se muestra el plan. Opcional.
displayNameSegments	Colección string	Segmentos de nombre para mostrar que se usan para representar dónde aparece el plano. Opcional.
webUrl	Cadena	Dirección URL de la superficie donde se muestra el plan. Opcional.
AssociationType	Cadena	Describe cómo se asocia el plan con la superficie. Opcional.
displayAs	plannerPlanContextType	Cómo se debe mostrar el vínculo de contexto. Los valores posibles son: teamsTab, sharePointPage, meetingNotes, other, unknownFutureValue, loopPage y project. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolutiva: loopPage , project. Opcional.
isActive	Booleano	Indica si el vínculo de contexto está activo actualmente. Opcional.
customLinkText	Cadena	Texto personalizado usado para representar el vínculo, si se proporciona. Opcional.
ownerAppId	Cadena	Id. de aplicación de la aplicación propietaria de la superficie desde la que está vinculado el plan. Opcional.
isCreation	Booleano	Indica si este vínculo de contexto representa la superficie de creación original del plan. Opcional.

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto planContextLink en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/me/planner/plans_v2/{planId}/contexts
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.planContextLink",
  "key": "19:abcdef1234567890abcdef1234567890@thread.tacv2",
  "displayNameSegments": [
    "Contoso Project"
  ],
  "webUrl": "https://teams.microsoft.com/l/entity/com.microsoft.teamspace.tab.planner/tab-contoso-project",
  "associationType": "primary",
  "displayAs": "teamsTab",
  "isActive": true,
  "customLinkText": "Project plan",
  "ownerAppId": "4d1c9a3e-7b52-4f8a-9d31-6c2e8f4b9a17",
  "isCreation": true
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.type": "#microsoft.graph.planContextLink",
  "id": "901187ee-a684-eeaa-61d0-b0fb4774cdab",
  "key": "String",
  "displayNameSegments": [
    "String"
  ],
  "webUrl": "String",
  "associationType": "String",
  "displayAs": "String",
  "isActive": "Boolean",
  "customLinkText": "String",
  "ownerAppId": "String",
  "isCreation": "Boolean",
  "createdDateTime": "String (timestamp)"
}