AdsApp.​FileUpload

AI-generated Key Takeaways

• Represents a bulk upload of an existing file from Blob, Google Sheet, or Drive File.

• Provides methods to apply or preview changes from the uploaded file.

• Allows specifying whether the upload is for campaign management or reporting offline conversions.

• Enables setting the file name for the uploaded file.

Represents a Bulk Upload of an already-existing file, loaded from Blob, Google Sheet or Drive File.

Methods:

Member	Type	Description
apply()	void	Uploads the file and applies the changes.
forCampaignManagement()	AdsApp.FileUpload	Specifies that this upload is used for Campaign Management entity changes.
forOfflineConversions()	AdsApp.FileUpload	Specifies that this upload is used for reporting offline conversions.
preview()	void	Uploads the file and previews the changes.
setFileName(fileName)	AdsApp.FileUpload	Sets the file name of the uploaded file.

apply()

Uploads the file and applies the changes.

When previewing a script, apply() previews the Bulk Upload instead of applying it.

Returns nothing.

forCampaignManagement()

Specifies that this upload is used for Campaign Management entity changes.

This is the default option, so this method doesn't need to be called except to override a previous call to FileUpload.forOfflineConversions().

Return values:

Type	Description
AdsApp.FileUpload	The same upload specified to change Campaign Management entities.

forOfflineConversions()

Specifies that this upload is used for reporting offline conversions.

By default, uploads are used for Campaign Management entity changes, so it's necessary to call FileUpload.forOfflineConversions() to make offline conversion uploads work correctly.

Return values:

Type	Description
AdsApp.FileUpload	The same upload specified to report offline conversions.

preview()

Uploads the file and previews the changes.

Returns nothing.

setFileName(fileName)

Sets the file name of the uploaded file.

Arguments:

Name	Type	Description
fileName	String	The file name of the uploaded file.

Return values:

Type	Description
AdsApp.FileUpload	The same upload with the file name applied.