- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- AdGroupKeywordSuggestion
- UnusableAdGroup
- جرِّبه الآن
تعرض قائمة بالمجموعات الإعلانية المقترحة والتعديلات المقترحة (النص، نوع المطابقة) للكلمات الرئيسية المحددة.
قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateAdGroupThemes
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "keywords": [ string ], "adGroups": [ string ] } |
الحقول | |
---|---|
keywords[] |
مطلوبة. قائمة بالكلمات الرئيسية المطلوب تجميعها في المجموعات الإعلانية المتوفرة. |
adGroups[] |
مطلوبة. قائمة بأسماء موارد المجموعات الإعلانية لتجميع الكلمات الرئيسية فيها. تنسيق اسم المورد: |
نص الاستجابة
رسالة الرد على KeywordPlanIdeaService.GenerateAdGroupThemes
.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "adGroupKeywordSuggestions": [ { object ( |
الحقول | |
---|---|
adGroupKeywordSuggestions[] |
قائمة بإقران المجموعات الإعلانية/الكلمات الرئيسية المقترحة. |
unusableAdGroups[] |
قائمة بالمجموعات الإعلانية المتوفرة التي تعذّر استخدامها كاقتراحات. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
AdGroupKeywordSuggestion
النص المقترح وإقران المجموعة الإعلانية/الحملة لكلمة رئيسية معينة.
تمثيل JSON |
---|
{
"keywordText": string,
"suggestedKeywordText": string,
"suggestedMatchType": enum ( |
الحقول | |
---|---|
keywordText |
نص الكلمة الرئيسية الأصلي. |
suggestedKeywordText |
النسخة التي تمت تسويتها من نص الكلمات الرئيسية لتقديم اقتراحات تقريبية/دقيقة/نصية. |
suggestedMatchType |
نوع مطابقة الكلمة الرئيسية المقترَح. |
suggestedAdGroup |
المجموعة الإعلانية المقترحة للكلمة الرئيسية. تنسيق اسم المورد: |
suggestedCampaign |
الحملة المقترحة للكلمة الرئيسية. تنسيق اسم المورد: |
UnusableAdGroup
زوج مجموعة إعلانية/حملة لا يمكن استخدامه كاقتراح للكلمات الرئيسية.
قد لا تكون المجموعات الإعلانية قابلة للاستخدام إذا كانت المجموعة الإعلانية
- ينتمي إلى حملة غير مفعّلة أو متوقفة مؤقتًا
- غير مفعّل في حد ذاته
تمثيل JSON |
---|
{ "adGroup": string, "campaign": string } |
الحقول | |
---|---|
adGroup |
اسم مورد المجموعة الإعلانية تنسيق اسم المورد: |
campaign |
اسم مورد الحملة. تنسيق اسم المورد: |