Fix warnings in doc build for apiclient

There was some invalid rst in the docstrings for apiclient which
caused several warnings during the doc build and also rendering
issues.

Closes-Bug: #1315523
Change-Id: I98c6061241eb462df4f78054b25a8920da6bcfd7
Merge "Fix warnings in doc build for apiclient"