Microsoft Graph API 元数据是否确认 OData 协议规范？

Question

Microsoft Graph API metadata

https://graph.microsoft.com/v1.0/ $metadata?detailed=true

ll.6791 - 6795

<Action Name="createSession" IsBound="true">
  <Parameter Name="this" Type="microsoft.graph.workbook"/>
  <Parameter Name="persistChanges" Type="Edm.Boolean" Nullable="false"/>
  <ReturnType Type="microsoft.graph.workbookSessionInfo"/>
</Action>

11.5.1 Binding an Operation to a Resource

http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part1-protocol/odata-v4.0-errata03-os-part1-protocol-complete.html#_Toc453752308

Actions and Functions MAY be bound to an entity type, primitive type, complex type, or a collection. The first parameter of a bound operation is the binding parameter .

---

"createSession" Action does not have "bindingParameter". Is this a correct specification for the Microsoft Graph API metadata? How can I report this to the Microsoft Graph team if this is an incorrect specification?

Answer 1

As you quoted, the spec says:

The first parameter of a bound operation is the binding parameter.

So in this case the parameter named "this" is the binding parameter. It is not necessary for the parameter to be named "bindingParameter".