Microsoft Graph: безопасно ли предположить, что plannerTask.id и plannerTaskDetails.id всегда одинаковы?

Question

При чтении документации Microsoft Graph мы сталкиваемся с двумя связанными типами ресурсов:

1. plannerTask
2. plannerTaskDetails

Оба plannerTask и plannerTaskDetails имеют атрибут id, который в обоих случаях имеет длину 28 символов и чувствителен к регистру, с проверкой, выполненной Microsoft.

При работе с Microsoft Graph я заметил, что для данной задачи plannerTask.id === plannerTaskDetails.id. Это имеет смысл, поскольку не было бы необходимости определять новый идентификатор для типа ресурса деталей, поскольку это отношение «один-один», и MS может просто повторно использовать идентификатор plannerTask.

Однако в документации идентификаторы, похоже, относятся к разным вещам. Я цитирую:

• Для plannerTask: "Идентификатор задачи "
• Для plannerTaskDetails: "Идентификатор задачи детали "

Это, кажется, оставляет возможность plannerTask.id !== plannerTaskDetails.id.

Мне просто интересно, если на опыте людей, можно ли предположить, что я заметил выше, то есть что дваидентификаторы всегда одинаковы, так как неясно работать с MS Graph и читать документацию. Возможно, кто-то, работающий над MS Planner, мог бы объяснить.

Answer 1

Вы не должны делать это предположение. С точки зрения API, это разные ключи. Используя Graph API, вам на самом деле не нужно нигде использовать идентификатор сведений о задаче, и вы всегда можете ссылаться на него как на подробности задачи abc.

В настоящее время значения идентификаторов совпадают, но мы активно изучаем некоторые особенности, которые требуют, чтобы они отличались. Если вы возьмете зависимость от этого, ваше приложение сломается.

Answer 2

Да, но если вы делаете патч-вызов, тогда заголовок If-Match, который является Etag, будет другим. Потому что, хотя задачи и детали задачи имеют одинаковый идентификатор, они являются разными объектами.