Add support for assetsByAssetIds Admin API

const-cloudinary · web-flow · commit b9a859076ec0 · 2021-10-31T18:36:32.000+02:00
diff --git a/src/Api/Admin/AssetsTrait.php b/src/Api/Admin/AssetsTrait.php
@@ -181,6 +181,27 @@ public function assetsByIds($publicIds, $options = [])
         return $this->apiClient->get($uri, $params);
     }
 
+    /**
+     * Lists assets with the specified asset IDs.
+     *
+     * @param string|array $assetIds  The requested asset IDs.
+     * @param array        $options   The optional parameters. See the
+     * <a href=https://cloudinary.com/documentation/admin_api#get_resources target="_blank"> Admin API</a> documentation.
+     *
+     * @return ApiResponse
+     *
+     * @see https://cloudinary.com/documentation/admin_api#get_resources
+     */
+    public function assetsByAssetIds($assetIds, $options = [])
+    {
+        $uri = [ApiEndPoint::ASSETS, 'by_asset_ids'];
+
+        $params              = ArrayUtils::whitelist($options, ['public_ids', 'tags', 'moderations', 'context']);
+        $params['asset_ids'] = $assetIds;
+
+        return $this->apiClient->get($uri, $params);
+    }
+
     /**
      * Returns the details of the specified asset and all its derived assets.
      *
diff --git a/tests/Integration/Admin/Assets/ListAssetsTest.php b/tests/Integration/Admin/Assets/ListAssetsTest.php
@@ -225,6 +225,40 @@ public function testListUploadedAssetsByIds()
         self::assertCount(2, $result['resources']);
     }
 
+    /**
+     * Get a single uploaded asset with a given Asset ID passed as a string.
+     */
+    public function testListUploadedAssetsByAssetId()
+    {
+        $result = self::$adminApi->assetsByAssetIds(self::getTestAssetAssetId(self::$UNIQUE_PREFIX));
+
+        self::assertValidAsset(
+            $result['resources'][0],
+            [
+                'public_id'    => self::getTestAssetPublicId(self::$UNIQUE_PREFIX),
+                AssetType::KEY => AssetType::IMAGE,
+            ]
+        );
+        self::assertCount(1, $result['resources']);
+    }
+
+    /**
+     * Get uploaded assets matching the Asset IDs passed as an array.
+     */
+    public function testListUploadedAssetsByAssetIds()
+    {
+        $result = self::$adminApi->assetsByAssetIds(
+            [
+                self::getTestAssetAssetId(self::$UNIQUE_PREFIX),
+                self::getTestAssetAssetId(self::TEST_ASSET)
+            ]
+        );
+
+        self::assertValidAsset($result['resources'][0]);
+        self::assertValidAsset($result['resources'][1]);
+        self::assertCount(2, $result['resources']);
+    }
+
     /**
      * Get images by tag.
      */
