Mit Status ändern können Sie verfolgen, welche Ressourcen sich innerhalb eines Kontos in einem bestimmten Zeitraum geändert haben. Wenn eine Ressource im angegebenen Zeitraum mehrere Änderungen hatte, wird nur die letzte Änderung zurückgegeben. Sie können dann feststellen, ob Sie Ihre lokalen Datenbankwerte mit denen synchronisieren müssen, die sich innerhalb des Zeitraums geändert haben.
Wenn Sie beispielsweise in einem bestimmten Zeitraum eine bestimmte Kampagne hinzufügen und dann aktualisieren, wird nur der Änderungsstatus für UPDATE und nicht für den Vorgang ADD zurückgegeben. Wenn Sie das Ende des Zeitraums vor der Aktualisierung verschieben, wird der Vorgang ADD angezeigt.
Wenn Sie die vollständigen Ergebnisse für einzelne Felder mit einer Detailansicht erhalten möchten, die der Webseite für den Änderungsverlauf ähnelt, lesen Sie Änderungsereignis.
Statustypen ändern
Die folgenden Ressourcentypen werden verfolgt. Die Ressourcentyp-IDs unterscheiden sich von den enum-Wertindexen von ChangeStatusResourceType.
| Ressourcentyp | Wert | Ressourcentyp-ID |
|---|---|---|
| Kernentitäten | ||
| Anzeigengruppe | AD_GROUP | 2 |
| Anzeige in Anzeigengruppe | AD_GROUP_AD | 3 |
| Gebotsanpassung für Anzeigengruppe | AD_GROUP_BID_MODIFIER | 11 |
| Kriterium für Anzeigengruppe | AD_GROUP_CRITERION | 4 |
| Anzeigengruppen-Feed | AD_GROUP_FEED | 12 |
| Kampagne | KAMPAGNE | 5 |
| Kampagnenkriterium | CAMPAIGN_CRITERION | 6 |
| Feeds | ||
| Kampagnen-Feed | CAMPAIGN_FEED | 9 |
| Feed | STROMVERSORGUNG | 8 |
| Feedelement | FEED_ITEM | 10 |
| Freigegebene Sätze | ||
| Freigegebener Satz | SHARED_SET | 17 |
| Freigegebener Kampagnensatz | CAMPAIGN_SHARED_SET | 18 |
| Assets | ||
| Asset | Asset | 13 |
| Asset des Kunden | CUSTOMER_ASSET | 14 |
| Asset der Kampagne | CAMPAIGN_ASSET | 15 |
| Asset der Anzeigengruppe | AD_GROUP_ASSET | 16 |
Ressourcentyp nach ID ermitteln
Die Google Ads API kann Zeilen mit dem Ressourcentyp UNKNOWN für frühere API-Versionen zurückgeben. Das bedeutet, dass der Typ in einer zukünftigen Version der Google Ads API unterstützt wird, zum Zeitpunkt der Veröffentlichung der aktuellen Version aber noch nicht vollständig unterstützt wurde. In diesem Fall können Sie trotzdem den Ressourcentyp der Zeile durch Parsen des zurückgegebenen resource_name ermitteln.
Das Format des Ressourcennamens ist:
customers/{customer_id}/changeStatus/{timestamp}-{resource_type_id}-{additional_ids}
Es können eine oder mehrere zusätzliche IDs vorhanden sein, die durch das Zeichen - getrennt sind. Relevant ist jedoch resource_type_id, also die zweite ID nach dem letzten Schrägstrich. In der vorherigen Tabelle sind alle Ressourcentyp-IDs aufgeführt.
Änderungen abrufen
Die Liste der Änderungen kann nach Datum und Ressourcentyp gefiltert werden. Der Vorgang für eine bestimmte Ressource ist entweder ADDED, CHANGED oder REMOVED.
Sie können die Liste aller Änderungen für alle Ressourcentypen abrufen. resource_type wird zurückgegeben und ist das geänderte Feld. Alle übergeordneten Felder werden ebenfalls ausgefüllt. Wenn sich beispielsweise ad_group_criterion geändert hat, enthält auch das Feld ad_group einen Wert.
Es kann bis zu 3 Minuten dauern, bis eine Änderung in den Ergebnissen des Änderungsstatus widergespiegelt wird.
Die Abfrage muss nach einem Datum innerhalb der letzten 90 Tage und optional nach einer Uhrzeit filtern. Außerdem muss sie eine LIMIT-Klausel enthalten, die auf maximal 10.000 Ergebnisse festgelegt ist.
Java
private void runExample(GoogleAdsClient googleAdsClient, long customerId) {
String query =
"SELECT change_status.resource_name, "
+ "change_status.last_change_date_time, "
+ "change_status.resource_status, "
+ "change_status.resource_type, "
+ "change_status.ad_group, "
+ "change_status.ad_group_ad, "
+ "change_status.ad_group_bid_modifier, "
+ "change_status.ad_group_criterion, "
+ "change_status.ad_group_feed, "
+ "change_status.campaign, "
+ "change_status.campaign_criterion, "
+ "change_status.campaign_feed, "
+ "change_status.feed, "
+ "change_status.feed_item "
+ "FROM change_status "
+ "WHERE change_status.last_change_date_time DURING LAST_14_DAYS "
+ "ORDER BY change_status.last_change_date_time "
+ "LIMIT 10000";
try (GoogleAdsServiceClient client =
googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
SearchPagedResponse response = client.search(String.valueOf(customerId), query);
for (GoogleAdsRow row : response.iterateAll()) {
Optional<String> resourceNameOfChangedEntity =
getResourceNameForResourceType(row.getChangeStatus());
System.out.printf(
"On '%s', change status '%s' shows a resource type of '%s' "
+ "with resource name '%s' was '%s'.%n",
row.getChangeStatus().getLastChangeDateTime(),
row.getChangeStatus().getResourceName(),
row.getChangeStatus().getResourceType().name(),
resourceNameOfChangedEntity.orElse(""),
row.getChangeStatus().getResourceStatus().name());
}
}
}
C#
public void Run(GoogleAdsClient client, long customerId)
{
// Get the GoogleAdsService.
GoogleAdsServiceClient googleAdsService = client.GetService(
Services.V16.GoogleAdsService);
string searchQuery = @"
SELECT
change_status.resource_name,
change_status.last_change_date_time,
change_status.resource_type,
change_status.campaign,
change_status.ad_group,
change_status.resource_status,
change_status.ad_group_ad,
change_status.ad_group_criterion,
change_status.campaign_criterion
FROM change_status
WHERE
change_status.last_change_date_time DURING LAST_14_DAYS
ORDER BY change_status.last_change_date_time
LIMIT 10000";
// Create a request that will retrieve all changes using pages of the specified
// page size.
SearchGoogleAdsRequest request = new SearchGoogleAdsRequest()
{
PageSize = PAGE_SIZE,
Query = searchQuery,
CustomerId = customerId.ToString()
};
try
{
// Issue the search request.
PagedEnumerable<SearchGoogleAdsResponse, GoogleAdsRow> searchPagedResponse =
googleAdsService.Search(request);
// Iterate over all rows in all pages and prints the requested field values for the
// campaign in each row.
foreach (GoogleAdsRow googleAdsRow in searchPagedResponse)
{
Console.WriteLine("Last change: {0}, Resource type: {1}, " +
"Resource name: {2}, Resource status: {3}, Specific resource name: {4}",
googleAdsRow.ChangeStatus.LastChangeDateTime,
googleAdsRow.ChangeStatus.ResourceType,
googleAdsRow.ChangeStatus.ResourceName,
googleAdsRow.ChangeStatus.ResourceStatus,
SpecificResourceName(googleAdsRow.ChangeStatus.ResourceType,
googleAdsRow));
}
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
/// <summary>
/// Return the name of the most specific resource that changed.
/// </summary>
/// <param name="resourceType">Type of the resource.</param>
/// <param name="row">Each returned row contains all possible changed fields</param>
/// <returns>The resource name of the changed field based on the resource type.
/// The changed field's parent is also populated, but is not used.</returns>
private string SpecificResourceName(ChangeStatusResourceType resourceType, GoogleAdsRow row)
{
string resourceName;
switch (resourceType)
{
case ChangeStatusResourceType.AdGroup:
resourceName = row.ChangeStatus.AdGroup;
break;
case ChangeStatusResourceType.AdGroupAd:
resourceName = row.ChangeStatus.AdGroupAd;
break;
case ChangeStatusResourceType.AdGroupCriterion:
resourceName = row.ChangeStatus.AdGroupCriterion;
break;
case ChangeStatusResourceType.Campaign:
resourceName = row.ChangeStatus.Campaign;
break;
case ChangeStatusResourceType.CampaignCriterion:
resourceName = row.ChangeStatus.CampaignCriterion;
break;
case ChangeStatusResourceType.Unknown:
case ChangeStatusResourceType.Unspecified:
default:
resourceName = "";
break;
}
return resourceName;
}
PHP
public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
$googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
// Creates a query to find information about changed resources in your account.
$query = 'SELECT change_status.resource_name, '
. 'change_status.last_change_date_time, '
. 'change_status.resource_status, '
. 'change_status.resource_type, '
. 'change_status.ad_group, '
. 'change_status.ad_group_ad, '
. 'change_status.ad_group_bid_modifier, '
. 'change_status.ad_group_criterion, '
. 'change_status.ad_group_feed, '
. 'change_status.campaign, '
. 'change_status.campaign_criterion, '
. 'change_status.campaign_feed, '
. 'change_status.feed, '
. 'change_status.feed_item '
. 'FROM change_status '
. 'WHERE change_status.last_change_date_time DURING LAST_14_DAYS '
. 'ORDER BY change_status.last_change_date_time '
. 'LIMIT 10000';
// Issues a search request by specifying page size.
$response = $googleAdsServiceClient->search(
SearchGoogleAdsRequest::build($customerId, $query)->setPageSize(self::PAGE_SIZE)
);
// Iterates over all rows in all pages and prints the requested field values for
// the change status in each row.
foreach ($response->iterateAllElements() as $googleAdsRow) {
/** @var GoogleAdsRow $googleAdsRow */
printf(
"On %s, change status '%s' shows resource '%s' with type '%s' and status '%s'.%s",
$googleAdsRow->getChangeStatus()->getLastChangeDateTime(),
$googleAdsRow->getChangeStatus()->getResourceName(),
self::getResourceNameForResourceType($googleAdsRow->getChangeStatus()),
ChangeStatusResourceType::name(
$googleAdsRow->getChangeStatus()->getResourceType()
),
ChangeStatusOperation::name($googleAdsRow->getChangeStatus()->getResourceStatus()),
PHP_EOL
);
}
}
/**
* Gets the resource name for the resource type of the change status object.
*
* Each returned row contains all possible changed resources, only one of which is populated
* with the name of the changed resource. This function returns the resource name of the
* changed resource based on the resource type.
*
* @param ChangeStatus $changeStatus the change status object for getting changed resource
* @return string the name of the resource that changed
*/
private static function getResourceNameForResourceType(
ChangeStatus $changeStatus
) {
$resourceType = $changeStatus->getResourceType();
$resourceName = ''; // Default value for UNSPECIFIED or UNKNOWN resource type.
switch ($resourceType) {
case ChangeStatusResourceType::AD_GROUP:
$resourceName = $changeStatus->getAdGroup();
break;
case ChangeStatusResourceType::AD_GROUP_AD:
$resourceName = $changeStatus->getAdGroupAd();
break;
case ChangeStatusResourceType::AD_GROUP_BID_MODIFIER:
$resourceName = $changeStatus->getAdGroupBidModifier();
break;
case ChangeStatusResourceType::AD_GROUP_CRITERION:
$resourceName = $changeStatus->getAdGroupCriterion();
break;
case ChangeStatusResourceType::AD_GROUP_FEED:
$resourceName = $changeStatus->getAdGroupFeed();
break;
case ChangeStatusResourceType::CAMPAIGN:
$resourceName = $changeStatus->getCampaign();
break;
case ChangeStatusResourceType::CAMPAIGN_CRITERION:
$resourceName = $changeStatus->getCampaignCriterion();
break;
case ChangeStatusResourceType::CAMPAIGN_FEED:
$resourceName = $changeStatus->getCampaignFeed();
break;
case ChangeStatusResourceType::FEED:
$resourceName = $changeStatus->getFeed();
break;
case ChangeStatusResourceType::FEED_ITEM:
$resourceName = $changeStatus->getFeedItem();
break;
}
return $resourceName;
}
Python
def main(client, customer_id):
ads_service = client.get_service("GoogleAdsService")
# Construct a query to find information about changed resources in your
# account.
query = """
SELECT
change_status.resource_name,
change_status.last_change_date_time,
change_status.resource_type,
change_status.campaign,
change_status.ad_group,
change_status.resource_status,
change_status.ad_group_ad,
change_status.ad_group_criterion,
change_status.campaign_criterion
FROM change_status
WHERE change_status.last_change_date_time DURING LAST_14_DAYS
ORDER BY change_status.last_change_date_time
LIMIT 10000"""
search_request = client.get_type("SearchGoogleAdsRequest")
search_request.customer_id = customer_id
search_request.query = query
search_request.page_size = _DEFAULT_PAGE_SIZE
response = ads_service.search(request=search_request)
for row in response:
cs = row.change_status
resource_type = cs.resource_type.name
if resource_type == "AD_GROUP":
resource_name = cs.ad_group
elif resource_type == "AD_GROUP_AD":
resource_name = cs.ad_group_ad
elif resource_type == "AD_GROUP_CRITERION":
resource_name = cs.ad_group_criterion
elif resource_type == "CAMPAIGN":
resource_name = cs.campaign
elif resource_type == "CAMPAIGN_CRITERION":
resource_name = cs.campaign_criterion
else:
resource_name = "UNKNOWN"
resource_status = cs.resource_status.name
print(
f"On '{cs.last_change_date_time}', change status "
f"'{cs.resource_name}' shows that a resource type of "
f"'{resource_type}' with resource name '{resource_name}' was "
f"{resource_status}"
)
Ruby
def get_change_summary(customer_id)
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Construct a query to find information about changed resources in your
# account.
query = <<~QUERY
SELECT
change_status.resource_name,
change_status.last_change_date_time,
change_status.resource_type,
change_status.campaign,
change_status.ad_group,
change_status.resource_status,
change_status.ad_group_ad,
change_status.ad_group_criterion,
change_status.campaign_criterion
FROM
change_status
WHERE change_status.last_change_date_time DURING LAST_14_DAYS
ORDER BY
change_status.last_change_date_time
LIMIT 10000
QUERY
# Execute the query.
response = client.service.google_ads.search(
customer_id: customer_id,
query: query,
page_size: PAGE_SIZE
)
# Process the results.
response.each do |row|
cs = row.change_status
resource_name = case cs.resource_type
when :AD_GROUP
cs.ad_group
when :AD_GROUP_AD
cs.ad_group_ad
when :AD_GROUP_CRITERION
cs.ad_group_criterion
when :CAMPAIGN
cs.campaign
when :CAMPAIGN_CRITERION
cs.campaign_criterion
else
"UNKNOWN"
end
puts "On #{cs.last_change_date_time}, change status #{cs.resource_name} " \
"shows a resource type of #{cs.resource_type} " \
"with resource name #{resource_name} was #{cs.resource_status}."
end
end
Perl
sub get_change_summary {
my ($api_client, $customer_id) = @_;
# Construct a search query to find information about changed resources in your
# account.
my $search_query =
"SELECT change_status.resource_name, change_status.last_change_date_time, "
. "change_status.resource_status, "
. "change_status.resource_type, "
. "change_status.ad_group, "
. "change_status.ad_group_ad, "
. "change_status.ad_group_bid_modifier, "
. "change_status.ad_group_criterion, "
. "change_status.ad_group_feed, "
. "change_status.campaign, "
. "change_status.campaign_criterion, "
. "change_status.campaign_feed, "
. "change_status.feed, "
. "change_status.feed_item "
. "FROM change_status "
. "WHERE change_status.last_change_date_time DURING LAST_14_DAYS "
. "ORDER BY change_status.last_change_date_time "
. "LIMIT 10000";
# Create a search Google Ads request that will retrieve all change statuses using
# pages of the specified page size.
my $search_request =
Google::Ads::GoogleAds::V16::Services::GoogleAdsService::SearchGoogleAdsRequest
->new({
customerId => $customer_id,
query => $search_query,
pageSize => PAGE_SIZE
});
# Get the GoogleAdsService.
my $google_ads_service = $api_client->GoogleAdsService();
my $iterator = Google::Ads::GoogleAds::Utils::SearchGoogleAdsIterator->new({
service => $google_ads_service,
request => $search_request
});
# Iterate over all rows in all pages and print the requested field values for
# the change status in each row.
while ($iterator->has_next) {
my $google_ads_row = $iterator->next;
my $change_status = $google_ads_row->{changeStatus};
printf "On %s, change status '%s' shows a resource type of '%s' " .
"with resource name '%s' was '%s'.\n",
$change_status->{lastChangeDateTime},
$change_status->{resourceName}, $change_status->{resourceType},
__get_resource_name_for_resource_type($change_status),
$change_status->{resourceStatus};
}
return 1;
}
# This method returns the resource name of the changed field based on the
# resource type. The changed field's parent is also populated but is not used.
sub __get_resource_name_for_resource_type {
my $change_status = shift;
my $resource_type = $change_status->{resourceType};
if ($resource_type eq AD_GROUP) {
return $change_status->{adGroup};
} elsif ($resource_type eq AD_GROUP_AD) {
return $change_status->{adGroupAd};
} elsif ($resource_type eq AD_GROUP_BID_MODIFIER) {
return $change_status->{adGroupBidModifier};
} elsif ($resource_type eq AD_GROUP_CRITERION) {
return $change_status->{adGroupCriterion};
} elsif ($resource_type eq AD_GROUP_FEED) {
return $change_status->{adGroupFeed};
} elsif ($resource_type eq CAMPAIGN) {
return $change_status->{campaign};
} elsif ($resource_type eq CAMPAIGN_CRITERION) {
return $change_status->{campaignCriterion};
} elsif ($resource_type eq CAMPAIGN_FEED) {
return $change_status->{campaignFeed};
} elsif ($resource_type eq FEED) {
return $change_status->{feed};
} elsif ($resource_type eq FEED_ITEM) {
return $change_status->{feedItem};
} else {
return "";
}
}
Lokal synchronisieren
Nachdem die genaue resource_name abgerufen wurde, sollte eine neue Abfrage mit diesem Ressourcennamen ausgeführt werden, um alle aktuellen Werte der Ressource zu erhalten. Der Änderungsstatus wird nicht für die geänderten Werte einer bestimmten Ressource verfolgt, sondern nur für welche Ressourcen sich geändert haben. Die Ermittlung des Unterschieds zwischen den vorherigen und aktuellen Werten liegt in der Verantwortung des aufrufenden Programms.
Zeitpunkt der Änderung
Das Feld last_change_date_time gibt an, wann die letzte Änderung an einer Ressource vorgenommen wurde. Daher kann die Aktualität der lokal im Cache gespeicherten Daten mit dem Wert dieses Felds verglichen werden, um festzustellen, ob die lokalen Daten veraltet sind.
Dieses Feld ist außerdem filterbar. Das bedeutet, dass es in der WHERE-Klausel einer GAQL-Abfrage (Google Ads Query Language) verwendet werden kann. Damit können Sie Änderungen an Ressourcen abfragen, die vor oder nach einem bestimmten Zeitpunkt aufgetreten sind.
Mit der folgenden GAQL-Prädikatklausel können Sie beispielsweise alle Änderungen ermitteln, die in der letzten Woche für einen bestimmten Ressourcentyp vorgenommen wurden:
WHERE change_status.last_change_date_time DURING LAST_7_DAYS