Nazwy zasobów

Niepowtarzalny identyfikator elementu w interfejsie Google Ads API nazywany jest nazwą zasobu i jest reprezentowany jako ciąg znaków w przewidywalnym formacie. Jeśli znasz składniki składowe nazwy zasobu, możesz generować nazwy zasobów przy użyciu metod pomocniczych obecnych w wielu obiektach usługi.

Metody ścieżek usługi

Wszystkie usługi, które są przeznaczone do obsługi odczytu lub mutacji określonych typów obiektów w interfejsie API, mają metody pomocnicze ułatwiające tworzenie obiektów resource_name. Na przykład utwórz nazwę zasobu dla obiektu Campaign:

from google.ads.googleads.client import GoogleAdsClient

client = GoogleAdsClient.load_from_storage()
customer_id = "7892134783"
campaign_id = "1234567890"
campaign_service = client.get_service("CampaignService")
resource_name = campaign_service.campaign_path(customer_id, campaign_id)

Począwszy od wersji biblioteki klienta 10.0.0, każda usługa ma też towarzyszącą metodę parse_*_path, która dekonstruuje element resource_name na segmenty, na przykład:

from google.ads.googleads.client import GoogleAdsClient

client = GoogleAdsClient.load_from_storage()
resource_name = "customers/7892134783/campaigns/1234567890"
campaign_service = client.get_service('CampaignService')
segments = campaign_service.parse_campaign_path(resource_name)
customer_id = segments["customer_id"]
campaign_id = segments["campaign_id"]

Nazwy zasobów złożonych

Począwszy od wersji 9.0.0 biblioteki klienta, asystenty ścieżek w usługach tworzą segmenty złożone o nazwie zasobu. Różne segmenty identyfikatora złożonego są akceptowane w metodzie jako indywidualne parametry:

from google.ads.google_ads.client import GoogleAdsClient

customer_id = "0987654321"
ad_group_id = "1234567890"
criterion_id = "74932"

client = GoogleAdsClient.load_from_storage()
ad_group_criterion_service = client.get_service("AdGroupCriterionService")

# An AdGroupCriterion resource name that uses the above IDs looks like this:
# "customers/0987654321/adGroupCriteria/1234567890~74932"
resource_name = ad_group_criterion_service.ad_group_criterion_path(
    customer_id, ad_group_id, criterion_id
)

Wersje starsze niż 9.0.0

W wersjach wcześniejszych niż 9.0.0 pomocnicze ścieżki w usługach nie tworzą segmentu złożonego o nazwie zasobu. Te segmenty musi dostarczyć osoba dzwoniąca. Biblioteka klienta zawiera małe narzędzie, które może Ci w tym pomóc:

from google.ads.google_ads.client import GoogleAdsClient
from google.ads.google_ads.util import ResourceName

customer_id = "0987654321"
ad_group_id = "1234567890"
criterion_id = "74932"

client = GoogleAdsClient.load_from_storage()
ad_group_criterion_service = client.get_service("AdGroupCriterionService")

# An AdGroupCriterion resource name that uses the above IDs looks like this:
# "customers/0987654321/adGroupCriteria/1234567890~74932"
composite_id = ResourceName.format_composite(ad_group_id, criterion_id)
resource_name = ad_group_criterion_service.ad_group_criterion_path(
    customer_id, composite_id
)
util.ResourceName