diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/Publisher.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/Publisher.java index 07a550496..aa140d7b9 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/Publisher.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/Publisher.java @@ -206,6 +206,9 @@ public String getTopicNameString() { * Schedules the publishing of a message. The publishing of the message may occur immediately or * be delayed based on the publisher batching options. * + *

This method blocks in the downcall if using LimitExceededBehavior.Block in the flow control + * settings. + * *

Example of publishing a message. * *

{@code
diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/PublisherInterface.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/PublisherInterface.java
index 80a465053..2a9d25b92 100644
--- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/PublisherInterface.java
+++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/PublisherInterface.java
@@ -28,6 +28,8 @@ public interface PublisherInterface {
    * Schedules the publishing of a message. The future will be returned with the message ID on
    * success or an exception on failure.
    *
+   * 

Some implementations of this method may block in the downcall until allowed by flow control. + * *

Example of publishing a message. * *

{@code