/// <summary>
/// Attaches a shared set to a campaign.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">The campaign id.</param>
/// <param name="sharedSetId">The shared set id.</param>
/// <returns>A CampaignSharedSet object that represents a binding between
/// the specified campaign and the shared set.</returns>
public CampaignSharedSet AttachSharedSetToCampaign(AdWordsUser user, long campaignId,
long sharedSetId)
{
using (CampaignSharedSetService campaignSharedSetService =
(CampaignSharedSetService)user.GetService(AdWordsService.v201802
.CampaignSharedSetService))
{
CampaignSharedSet campaignSharedSet = new CampaignSharedSet
{
campaignId = campaignId,
sharedSetId = sharedSetId
};
CampaignSharedSetOperation operation = new CampaignSharedSetOperation
{
@operator = Operator.ADD,
operand = campaignSharedSet
};
CampaignSharedSetReturnValue retval = campaignSharedSetService.mutate(
new CampaignSharedSetOperation[]
{
operation
});
return(retval.value[0]);
}
}
/// <summary>Snippet for MutateCampaignSharedSets</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void MutateCampaignSharedSets()
{
// Create client
CampaignSharedSetServiceClient campaignSharedSetServiceClient = CampaignSharedSetServiceClient.Create();
// Initialize request argument(s)
string customerId = "";
IEnumerable <CampaignSharedSetOperation> operations = new CampaignSharedSetOperation[]
{
new CampaignSharedSetOperation(),
};
// Make the request
MutateCampaignSharedSetsResponse response = campaignSharedSetServiceClient.MutateCampaignSharedSets(customerId, operations);
}
/// <summary>
/// Detaches the shared set from campaign.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">The campaign identifier.</param>
/// <param name="sharedSetId">The shared set identifier.</param>
public void DetachSharedSetFromCampaign(AdWordsUser user, long campaignId, long sharedSetId)
{
// Get the CampaignSharedSetService.
CampaignSharedSetService campaignSharedSetService = (CampaignSharedSetService)
user.GetService(AdWordsService.v201607.CampaignSharedSetService);
CampaignSharedSet campaignSharedSet = new CampaignSharedSet();
campaignSharedSet.campaignId = campaignId;
campaignSharedSet.sharedSetId = sharedSetId;
CampaignSharedSetOperation operation = new CampaignSharedSetOperation();
operation.@operator = Operator.REMOVE;
operation.operand = campaignSharedSet;
campaignSharedSetService.mutate(new CampaignSharedSetOperation[] { operation });
}
/// <summary>
/// Attaches a shared set to a campaign.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">The campaign id.</param>
/// <param name="sharedSetId">The shared set id.</param>
/// <returns>A CampaignSharedSet object that represents a binding between
/// the specified campaign and the shared set.</returns>
public CampaignSharedSet AttachSharedSetToCampaign(AdWordsUser user, long campaignId,
long sharedSetId)
{
using (CampaignSharedSetService campaignSharedSetService = (CampaignSharedSetService)
user.GetService(AdWordsService.v201708.CampaignSharedSetService)) {
CampaignSharedSet campaignSharedSet = new CampaignSharedSet();
campaignSharedSet.campaignId = campaignId;
campaignSharedSet.sharedSetId = sharedSetId;
CampaignSharedSetOperation operation = new CampaignSharedSetOperation();
operation.@operator = Operator.ADD;
operation.operand = campaignSharedSet;
CampaignSharedSetReturnValue retval = campaignSharedSetService.mutate(
new CampaignSharedSetOperation[] { operation });
return(retval.value[0]);
}
}
/// <summary>Snippet for MutateCampaignSharedSetsAsync</summary>
public async Task MutateCampaignSharedSetsAsync()
{
// Snippet: MutateCampaignSharedSetsAsync(string, IEnumerable<CampaignSharedSetOperation>, CallSettings)
// Additional: MutateCampaignSharedSetsAsync(string, IEnumerable<CampaignSharedSetOperation>, CancellationToken)
// Create client
CampaignSharedSetServiceClient campaignSharedSetServiceClient = await CampaignSharedSetServiceClient.CreateAsync();
// Initialize request argument(s)
string customerId = "";
IEnumerable <CampaignSharedSetOperation> operations = new CampaignSharedSetOperation[]
{
new CampaignSharedSetOperation(),
};
// Make the request
MutateCampaignSharedSetsResponse response = await campaignSharedSetServiceClient.MutateCampaignSharedSetsAsync(customerId, operations);
// End snippet
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// <param name="campaignId">The ID of the campaign for which shared criterion is updated.
/// </param>
public void Run(GoogleAdsClient client, long customerId, long campaignId)
{
SharedSetServiceClient sharedSetService = client.GetService(
Services.V4.SharedSetService);
SharedCriterionServiceClient sharedCriterionService =
client.GetService(Services.V4.SharedCriterionService);
CampaignSharedSetServiceClient campaignSharedSetService =
client.GetService(Services.V4.CampaignSharedSetService);
try
{
// Keywords to create a shared set of.
string[] keywords = new string[] { "mars cruise", "mars hotels" };
// Create shared negative keyword set.
SharedSet sharedSet = new SharedSet()
{
Name = "API Negative keyword list - " + ExampleUtilities.GetRandomString(),
Type = SharedSetType.NegativeKeywords,
};
SharedSetOperation operation = new SharedSetOperation()
{
Create = sharedSet
};
MutateSharedSetsResponse sharedSetResponse = sharedSetService.MutateSharedSets(
customerId.ToString(), new SharedSetOperation[] { operation });
string sharedSetResourceName = sharedSetResponse.Results[0].ResourceName;
Console.WriteLine($"Created shared set {sharedSetResourceName}.");
// Create negative keywords in the shared set.
List <SharedCriterionOperation> criterionOperations =
new List <SharedCriterionOperation>();
foreach (string keyword in keywords)
{
SharedCriterion sharedCriterion = new SharedCriterion()
{
Keyword = new KeywordInfo()
{
Text = keyword,
MatchType = KeywordMatchType.Broad
},
SharedSet = sharedSetResourceName
};
criterionOperations.Add(new SharedCriterionOperation()
{
Create = sharedCriterion
});
}
MutateSharedCriteriaResponse criteriaResponse =
sharedCriterionService.MutateSharedCriteria(
customerId.ToString(), criterionOperations);
foreach (MutateSharedCriterionResult result in criteriaResponse.Results)
{
Console.WriteLine($"Created shared criterion {result.ResourceName}.");
}
// Attach shared set to campaign.
CampaignSharedSet campaignSet = new CampaignSharedSet()
{
Campaign = ResourceNames.Campaign(customerId, campaignId),
SharedSet = sharedSetResourceName
};
CampaignSharedSetOperation sharedSetoperation = new CampaignSharedSetOperation()
{
Create = campaignSet
};
MutateCampaignSharedSetsResponse response =
campaignSharedSetService.MutateCampaignSharedSets(customerId.ToString(),
new CampaignSharedSetOperation[] { sharedSetoperation });
Console.WriteLine("Created campaign shared set {0}.",
response.Results[0].ResourceName);
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
/// <summary>
/// Attaches a shared set to a campaign.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">The campaign id.</param>
/// <param name="sharedSetId">The shared set id.</param>
/// <returns>A CampaignSharedSet object that represents a binding between
/// the specified campaign and the shared set.</returns>
public CampaignSharedSet AttachSharedSetToCampaign(AdWordsUser user, long campaignId,
long sharedSetId)
{
// Get the CampaignSharedSetService.
CampaignSharedSetService campaignSharedSetService = (CampaignSharedSetService)
user.GetService(AdWordsService.v201601.CampaignSharedSetService);
CampaignSharedSet campaignSharedSet = new CampaignSharedSet();
campaignSharedSet.campaignId = campaignId;
campaignSharedSet.sharedSetId = sharedSetId;
CampaignSharedSetOperation operation = new CampaignSharedSetOperation();
operation.@operator = Operator.ADD;
operation.operand = campaignSharedSet;
CampaignSharedSetReturnValue retval = campaignSharedSetService.mutate(
new CampaignSharedSetOperation[] {operation});
return retval.value[0];
}
/// <summary>
/// Detaches the shared set from campaign.
/// </summary>
/// <param name="user">The user.</param>
/// <param name="campaignId">The campaign identifier.</param>
/// <param name="sharedSetId">The shared set identifier.</param>
public void DetachSharedSetFromCampaign(AdWordsUser user, long campaignId, long sharedSetId)
{
// Get the CampaignSharedSetService.
CampaignSharedSetService campaignSharedSetService = (CampaignSharedSetService)
user.GetService(AdWordsService.v201601.CampaignSharedSetService);
CampaignSharedSet campaignSharedSet = new CampaignSharedSet();
campaignSharedSet.campaignId = campaignId;
campaignSharedSet.sharedSetId = sharedSetId;
CampaignSharedSetOperation operation = new CampaignSharedSetOperation();
operation.@operator = Operator.REMOVE;
operation.operand = campaignSharedSet;
campaignSharedSetService.mutate(new CampaignSharedSetOperation[] { operation });
}
