Support response data for APIServer::send_homeassistant_service_call

[olicooper]

Describe the problem you have/What new integration you would like

I would like to fetch weather forecast updates via the HA service call weather.get_forecasts. This returns a json response, but APIServer::send_homeassistant_service_call does not support returning a response. There is no other way to get weather forecasts in HA v2024.4 onwards so this is the only way forward unfortunately.

This will likely also need the request object to support other request keys such as target rather than just the data key.

Please describe your use case for this integration and alternatives you've tried:

In HA versions prior to v2024.4, you could subscribe to forecast updates, but this has been removed recently.

Additional context

Service documentation: https://www.home-assistant.io/integrations/weather#service-weatherget_forecasts

Example request:

service: weather.get_forecasts
data:
  type: daily
target:
  entity_id:
    - weather.my_weather_entity

Example response:

weather.my_weather_entity:
  forecast:
    - datetime: "2024-04-27T12:00:00+00:00"
      condition: sunny
      precipitation_probability: 12
      wind_bearing: NE
      temperature: 15
      wind_speed: 12
 ...