diff --git a/storage/google/cloud/storage/blob.py b/storage/google/cloud/storage/blob.py
index a9d28dda9e75..c68867fd6830 100644
--- a/storage/google/cloud/storage/blob.py
+++ b/storage/google/cloud/storage/blob.py
@@ -1093,8 +1093,9 @@ def create_resumable_upload_session(
     def get_iam_policy(self, client=None):
         """Retrieve the IAM policy for the object.
 
-        See
-        https://cloud.google.com/storage/docs/json_api/v1/objects/getIamPolicy
+        .. warning::
+
+           The ``objects.getIamPolicy`` API is deprecated.
 
         :type client: :class:`~google.cloud.storage.client.Client` or
                       ``NoneType``
@@ -1122,8 +1123,9 @@ def get_iam_policy(self, client=None):
     def set_iam_policy(self, policy, client=None):
         """Update the IAM policy for the bucket.
 
-        See
-        https://cloud.google.com/storage/docs/json_api/v1/objects/setIamPolicy
+        .. warning::
+
+           The ``objects.setIamPolicy`` API is deprecated.
 
         :type policy: :class:`google.cloud.iam.Policy`
         :param policy: policy instance used to update bucket's IAM policy.
@@ -1157,8 +1159,9 @@ def set_iam_policy(self, policy, client=None):
     def test_iam_permissions(self, permissions, client=None):
         """API call:  test permissions
 
-        See
-        https://cloud.google.com/storage/docs/json_api/v1/objects/testIamPermissions
+        .. warning::
+
+           The ``objects.testIamPermissions`` API is deprecated.
 
         :type permissions: list of string
         :param permissions: the permissions to check