Allow external caller to set current asset in the source plugin

Problem/Motivation

On media save, the AcquiadamAsset source plugin makes calls to fetch the current asset, and its metadata.

Since callers to save the media may already have the asset and its metadata (from API requests to the DAM to retrieve this info in batches), it would be great if they could inject this so that additional calls to the DAM are avoided.

When synchronizing hundreds or thousands of items from the DAM, this quickly leads to 'too many requests' exceptions from the DAM.

Steps to reproduce

Proposed resolution

Add a AcquiadamAsset::setCurrentAsset() method.

Sample usage:

      // We already have the asset, prevent acquiadam from making the call.
      /** @var \Drupal\media_acquiadam\Plugin\media\Source\AcquiadamAsset $source */
      $source = $media->getSource();
      $source->setCurrentAsset($this->asset);
      $media->save();

Remaining tasks

User interface changes

API changes

Data model changes