Class MediaResource
The "media" collection of methods.
Inherited Members
Namespace: Google.Apis.CloudSupport.v2
Assembly: Google.Apis.CloudSupport.v2.dll
Syntax
public class MediaResource
Constructors
MediaResource(IClientService)
Constructs a new resource.
Declaration
public MediaResource(IClientService service)
Parameters
Type | Name | Description |
---|---|---|
IClientService | service |
Methods
Download(string)
Download a file attached to a case. Note: HTTP requests must append "?alt=media" to the URL. EXAMPLES: cURL:
shell name="projects/some-project/cases/43594844/attachments/0674M00000WijAnZAJ" curl \ --header
"Authorization: Bearer $(gcloud auth print-access-token)" \
"https://cloudsupport.googleapis.com/v2/$name:download?alt=media"
Python:
python import
googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build(
serviceName="cloudsupport", version=api_version,
discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request
= supportApiService.media().download(
name="projects/some-project/cases/43595344/attachments/0684M00000Pw6pHQAR" ) request.uri =
request.uri.split("?")[0] + "?alt=media" print(request.execute())
Declaration
public virtual MediaResource.DownloadRequest Download(string name)
Parameters
Type | Name | Description |
---|---|---|
string | name | The name of the file attachment to download. |
Returns
Type | Description |
---|---|
MediaResource.DownloadRequest |
Upload(CreateAttachmentRequest, string)
Create a file attachment on a case or Cloud resource. The attachment must have the following fields set:
filename
. EXAMPLES: cURL:
shell echo "This text is in a file I'm uploading using CSAPI." \ >
"./example_file.txt" case="projects/some-project/cases/43594844" curl \ --header "Authorization: Bearer
$(gcloud auth print-access-token)" \ --data-binary @"./example_file.txt" \
"https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt"
Python:
python import googleapiclient.discovery api_version = "v2" supportApiService =
googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version,
discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", )
file_path = "./example_file.txt" with open(file_path, "w") as file: file.write( "This text is inside a file
I'm going to upload using the Cloud Support API.", ) request = supportApiService.media().upload(
parent="projects/some-project/cases/43595344", media_body=file_path ) request.uri =
request.uri.split("?")[0] + "?attachment.filename=uploaded_via_python.txt" print(request.execute())
Declaration
public virtual MediaResource.UploadRequest Upload(CreateAttachmentRequest body, string parent)
Parameters
Type | Name | Description |
---|---|---|
CreateAttachmentRequest | body | The body of the request. |
string | parent | Required. The name of the case or Cloud resource to which the attachment should be attached. |
Returns
Type | Description |
---|---|
MediaResource.UploadRequest |
Upload(CreateAttachmentRequest, string, Stream, string)
Create a file attachment on a case or Cloud resource. The attachment must have the following fields set:
filename
. EXAMPLES: cURL:
shell echo "This text is in a file I'm uploading using CSAPI." \ >
"./example_file.txt" case="projects/some-project/cases/43594844" curl \ --header "Authorization: Bearer
$(gcloud auth print-access-token)" \ --data-binary @"./example_file.txt" \
"https://cloudsupport.googleapis.com/upload/v2beta/$case/attachments?attachment.filename=uploaded_via_curl.txt"
Python:
python import googleapiclient.discovery api_version = "v2" supportApiService =
googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version,
discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", )
file_path = "./example_file.txt" with open(file_path, "w") as file: file.write( "This text is inside a file
I'm going to upload using the Cloud Support API.", ) request = supportApiService.media().upload(
parent="projects/some-project/cases/43595344", media_body=file_path ) request.uri =
request.uri.split("?")[0] + "?attachment.filename=uploaded_via_python.txt" print(request.execute())
Declaration
public virtual MediaResource.UploadMediaUpload Upload(CreateAttachmentRequest body, string parent, Stream stream, string contentType)
Parameters
Type | Name | Description |
---|---|---|
CreateAttachmentRequest | body | The body of the request. |
string | parent | Required. The name of the case or Cloud resource to which the attachment should be attached. |
Stream | stream | The stream to upload. See remarks for further information. |
string | contentType | The content type of the stream to upload. |
Returns
Type | Description |
---|---|
MediaResource.UploadMediaUpload |
Remarks
Considerations regarding stream
:
-
If
stream
is seekable, then the stream position will be reset to0
before reading commences. Ifstream
is not seekable, then it will be read from its current position -
Caller is responsible for maintaining the
stream
open until the upload is completed - Caller is responsible for closing the
stream