Part of [Epic] Create Metrics Platform API for Submitting Core Interaction Events
Description
Add/update the Metrics Platform API to include the newly drafted core interaction events methods.
Additional Notes
The preliminary core interactions API were proposed in a recent spike (see T345439#9217684).
Pending the outcome of T349416, the Javascript and Java libraries (PHP is still in progress but presumably can be articulated; Swift TK) have been/are being refactored to provide a submitInteraction() method that will serve as the basis for other specific submit methods (i.e. submitClick(), submitView(), etc).
Because we opted for option 2 in T345906#9211043, for the few instruments currently in production using the MP monoschema (applicable to web clients only), we will need to maintain the existing API until those instruments are refactored to use the new core interactions schemas. The current documentation on Wikitech for Javascript and PHP is relevant for monoschema usage and should be preserved until/if/when we decommission the monoschema fully.
Acceptance Criteria
- Add/update documentation on Wikitech (https://wikitech.wikimedia.org/wiki/Metrics_Platform/Implementations#API) to include new core interactions API methods for the Javascript, PHP, and Java libraries (Swift TK).
- Ensure that monoschema usage for Javascript and PHP libraries is preserved and explicitly marked for deprecation.
- Ensure that the DocBlocks for all the core interactions API methods in the different libraries (excluding Swift for now) are fully detailed and match the API documentation.